From 0dfdf66f820088709768e6d7f9249559149901d8 Mon Sep 17 00:00:00 2001 From: Mohd Kaif <98801504+KaifAhmad1@users.noreply.github.com> Date: Thu, 11 Jun 2026 21:14:12 +0530 Subject: [PATCH] docs(readme): remove dividers, rebrand to semantica-agi org (#612) Remove all horizontal rule dividers for a cleaner premium look. Replace all Hawksight-AI references with semantica-agi org URLs and update footer attribution from Hawksight AI to Semantica. --- README.md | 94 +++++++------------------------------------------------ 1 file changed, 11 insertions(+), 83 deletions(-) diff --git a/README.md b/README.md index b3c5e41b..fd5e0fa6 100644 --- a/README.md +++ b/README.md @@ -10,7 +10,7 @@ [![Total Downloads](https://static.pepy.tech/badge/semantica?style=flat-square)](https://pepy.tech/project/semantica) [![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg?style=flat-square)](https://www.python.org/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT) -[![CI](https://img.shields.io/github/actions/workflow/status/Hawksight-AI/semantica/ci.yml?style=flat-square&label=CI)](https://github.com/Hawksight-AI/semantica/actions) +[![CI](https://img.shields.io/github/actions/workflow/status/semantica-agi/semantica/ci.yml?style=flat-square&label=CI)](https://github.com/semantica-agi/semantica/actions) [![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/sV34vps5hH) [![Docs](https://img.shields.io/badge/Docs-docs.getsemantica.ai-0099FF?style=flat-square&logo=readthedocs&logoColor=white)](https://docs.getsemantica.ai/) @@ -18,8 +18,6 @@ ---- - > Most AI agents act without a trail. > > They store embeddings, not meaning. They make decisions that cannot be audited, recall context that cannot be explained, and produce outputs that cannot be traced back to a source. Regulators, auditors, and enterprise risk teams are asking the same question: **can you prove what your AI did and why?** @@ -35,12 +33,8 @@ - **Reasoning Engines** — forward chaining, Rete network, Datalog, SPARQL — explainable paths, not black boxes - **Drop-in Integrations** — Agno native, 12-tool MCP server, 50+ CLI commands, 109 REST endpoints, plugins for 8 editors ---- - **[Quick Start](#quick-start)**  ·  **[Why Semantica](#why-semantica)**  ·  **[Architecture](#architecture)**  ·  **[Context Graphs](#context-graphs)**  ·  **[Decision Intelligence](#decision-intelligence)**  ·  **[Module Showcase](#module-showcase)**  ·  **[CLI](#cli)**  ·  **[Integrations](#integrations)**  ·  **[Performance](#performance)**  ·  **[Install](#installation)** ---- - ## See It in Action
@@ -65,8 +59,6 @@
---- - ## Quick Start ```bash @@ -98,12 +90,10 @@ compliant = graph.check_decision_rules({"category": "vendor_selection"}) # poli If Semantica solves a real problem for you, a star helps others find it. -**[⭐ Star on GitHub](https://github.com/Hawksight-AI/semantica)**  ·  **[Join Discord](https://discord.gg/sV34vps5hH)** +**[⭐ Star on GitHub](https://github.com/semantica-agi/semantica)**  ·  **[Join Discord](https://discord.gg/sV34vps5hH)** ---- - ## Why Semantica | | Vector DB + RAG | Plain LLM Memory | **Semantica** | @@ -121,10 +111,6 @@ If Semantica solves a real problem for you, a star helps others find it. Semantica does not replace your LLM or your vector store — it adds the structured intelligence and accountability layer they cannot provide. - - ---- - ## Context Graphs A Context Graph is the structured memory layer that traditional RAG is missing. Instead of flat embeddings that answer *"what is similar?"*, a Context Graph answers *"what is connected, why, and how?"* @@ -165,8 +151,6 @@ retrieved = ctx.retrieve("who approved the Acme contract?") - Conflicts are detected and flagged before they corrupt your knowledge base - Point-in-time snapshots let you replay history without reprocessing ---- - ## Decision Intelligence Decision Intelligence turns every AI choice from an ephemeral inference into a permanent, auditable, queryable record. It answers *"what did your AI decide, why, and what happened next?"* — the question regulators and enterprise risk teams ask with increasing frequency. @@ -222,8 +206,6 @@ impact = graph.analyze_decision_impact(uw_id) compliant = graph.check_decision_rules({"category": "loan_underwriting", "confidence": 0.94}) ``` ---- - ## Module Showcase Semantica is a full platform. Every module is independently importable and composable. Below are working examples for each. @@ -252,8 +234,6 @@ rows = DBIngestor().ingest_database( ) ``` ---- - ### `semantica.semantic_extract` — NER, Relations, Events, Triplets Extract structured knowledge from raw text in one pass. @@ -282,8 +262,6 @@ triplets = TripletExtractor().extract_triplets(text) # → [("Anthropic", "valuation", "$61.5B"), ("Dario Amodei", "is_ceo_of", "Anthropic"), ...] ``` ---- - ### `semantica.kg` — Knowledge Graph Construction & Analysis Build a production knowledge graph from documents and run graph algorithms over it. @@ -306,8 +284,6 @@ bridges = analyzer.identify_bridges(kg) # single points paths = analyzer.find_shortest_path(kg, "alice", "contract_001") ``` ---- - ### `semantica.reasoning` — Forward Chaining, Rete, Datalog, SPARQL Run explainable rule-based inference — not a black box. @@ -357,8 +333,6 @@ ancestors = engine.query("ancestor(tom, ?X)") # → [{"X": "bob"}, {"X": "ann"}, {"X": "pat"}] ``` ---- - ### `semantica.vector_store` — Hybrid & Filtered Semantic Search Drop-in vector store with 7 backends, hybrid search, and decision-aware retrieval. @@ -391,8 +365,6 @@ hits = hs.search("high-risk transactions 2024") explanation = vs.explain_decision(results[0]["id"]) ``` ---- - ### `semantica.provenance` — W3C PROV-O Lineage Every fact linked to its source — no black boxes, no mystery outputs. @@ -422,8 +394,6 @@ trail = prov.trace_lineage("alice_chen") # full ancestor chain entry = prov.get_provenance("acme_corp") ``` ---- - ### `semantica.ontology` — OWL Generation, SHACL Validation Generate ontologies from data, validate shapes, and manage your vocabulary. @@ -453,8 +423,6 @@ report = validator.validate(ontology) # → ValidationResult(conforms=True, errors=[], warnings=[]) ``` ---- - ### `semantica.deduplication` — Entity Resolution at Scale Block, cluster, and merge duplicates with semantic similarity — **6.98× faster** than baseline. @@ -479,8 +447,6 @@ ops = merger.merge_duplicates(entities, strategy="keep_most_complete") history = merger.get_merge_history() ``` ---- - ### `semantica.pipeline` — Pipeline DSL Compose ingestion, extraction, and graph-building into a declarative, parallel pipeline. @@ -511,8 +477,6 @@ status = engine.get_status(pipeline) progress = engine.get_progress(pipeline) ``` ---- - ### `semantica.temporal` — Bi-Temporal Graphs & Time Travel Track when facts were true *in the world* vs. when they were *recorded* — and query either axis. @@ -540,8 +504,6 @@ fact = BiTemporalFact( ) ``` ---- - ### `semantica.export` — RDF, OWL, Parquet, Cypher, JSON-LD Export to any format required by regulators, graph databases, or downstream systems. @@ -569,8 +531,6 @@ JSONExporter().export_knowledge_graph(kg, "kg.json") LPGExporter().export(kg, "kg_import.cypher", method="cypher") ``` ---- - ### `semantica.visualization` — Interactive Graph Workbench Render force-directed graphs, community maps, ontology hierarchies, and temporal dashboards. @@ -594,8 +554,6 @@ emb_viz = EmbeddingVisualizer() emb_viz.visualize_2d_projection(embeddings=np.array([...]), labels=["..."], method="umap") ``` ---- - ### Multi-Agent Shared Context with Agno One shared intelligence layer — all agents read and write to the same context graph. @@ -632,9 +590,7 @@ team = Team(agents=[researcher, analyst], mode="coordinate") # Researcher's findings are instantly available to the Analyst — no copy, no sync ``` -→ [40+ runnable notebooks in the cookbook](https://github.com/Hawksight-AI/semantica/tree/main/cookbook) - ---- +→ [40+ runnable notebooks in the cookbook](https://github.com/semantica-agi/semantica/tree/main/cookbook) ## Performance @@ -647,8 +603,6 @@ Benchmarks from v0.5.0 on a 118,000-node production graph: | Semantic deduplication | baseline | optimized candidate gen | **6.98×** faster | | Candidate generation | baseline | blocking strategy | **63.6%** faster | ---- - ## CLI Every capability is available from the terminal. The CLI ships with the package — no separate install. @@ -716,8 +670,6 @@ $ semantica doctor → [Full CLI reference](https://docs.getsemantica.ai/) ---- - ## Integrations Native plugin bundles for 8 editors · MCP server with 12 tools · 109-endpoint REST API · Agno first-class · 100+ LLMs via LiteLLM @@ -898,8 +850,6 @@ python -m semantica.mcp_server Bundles for Claude Code, Cursor, Codex, Windsurf, Cline, Continue, VS Code, and OpenClaw in [`plugins/`](plugins/). ---- - ## Knowledge Explorer A browser-based graph workbench — pan and zoom live graphs, scrub the timeline, review every decision's causal chain, resolve duplicates, author your ontology visually. Built on React 19 + Sigma.js. @@ -921,8 +871,6 @@ cd explorer && npm install && npm run dev # UI on port 5173 → [`explorer/README.md`](explorer/README.md) ---- - ## Modules | Module | What it provides | @@ -943,8 +891,6 @@ cd explorer && npm install && npm run dev # UI on port 5173 | `semantica.visualization` | KG, ontology, embedding, temporal, and community graph visualization | | [`explorer/`](explorer/) | React 19 + Sigma.js browser workbench | ---- - ## Features | Capability | Highlights | @@ -961,8 +907,6 @@ cd explorer && npm install && npm run dev # UI on port 5173 | **Graph Databases** | Neo4j · FalkorDB · Apache AGE · AWS Neptune | | **LLM Providers** | 100+ models via LiteLLM — OpenAI · Anthropic · Groq · Ollama · Azure · Bedrock | ---- - ## What's New in v0.5.0 - **Distance Intelligence** — 10× embedding cache, N×N semantic distance matrix, Ego Mode explorer, 5 new API endpoints @@ -973,8 +917,6 @@ cd explorer && npm install && npm run dev # UI on port 5173 → [Full release notes](RELEASE_NOTES.md) · [Changelog](CHANGELOG.md) ---- - ## Built for High-Stakes Domains Semantica is designed for environments where AI outputs must be explainable, auditable, and defensible. @@ -986,8 +928,6 @@ Semantica is designed for environments where AI outputs must be explainable, aud - **Government** — policy decision records, classified information governance, regulatory reporting - **Autonomous Systems** — decision logs, safety validation, explainable AI for certification ---- - ## Installation ```bash @@ -1010,33 +950,27 @@ pip install semantica[watch] # Directory file watcher From source: ```bash -git clone https://github.com/Hawksight-AI/semantica.git +git clone https://github.com/semantica-agi/semantica.git cd semantica && pip install -e ".[dev]" && pytest tests/ ``` ---- - ## Enterprise On-premises deployment · Private cloud · Custom domain implementations · SLA-backed support · Professional services for regulated industries (healthcare, finance, legal, government). **[getsemantica.ai](https://getsemantica.ai/)** for enterprise solutions and pricing. ---- - ## Community & Support | | | | --- | --- | | **Discord** | [discord.gg/sV34vps5hH](https://discord.gg/sV34vps5hH) — real-time help, showcases, announcements | -| **GitHub Discussions** | [Q&A and feature requests](https://github.com/Hawksight-AI/semantica/discussions) | -| **GitHub Issues** | [Bug reports](https://github.com/Hawksight-AI/semantica/issues) | +| **GitHub Discussions** | [Q&A and feature requests](https://github.com/semantica-agi/semantica/discussions) | +| **GitHub Issues** | [Bug reports](https://github.com/semantica-agi/semantica/issues) | | **Documentation** | [docs.getsemantica.ai](https://docs.getsemantica.ai/) | -| **Cookbook** | [40+ runnable Jupyter notebooks](https://github.com/Hawksight-AI/semantica/tree/main/cookbook) | +| **Cookbook** | [40+ runnable Jupyter notebooks](https://github.com/semantica-agi/semantica/tree/main/cookbook) | | **Changelog** | [CHANGELOG.md](CHANGELOG.md) · [Release Notes](RELEASE_NOTES.md) | ---- - ## Star History @@ -1047,8 +981,6 @@ On-premises deployment · Private cloud · Custom domain implementations · SLA- ---- - ## Contributors
@@ -1057,8 +989,6 @@ On-premises deployment · Private cloud · Custom domain implementations · SLA-
---- - ## Contributing All contributions welcome — bug fixes, features, tests, and docs. @@ -1070,13 +1000,11 @@ All contributions welcome — bug fixes, features, tests, and docs. See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines. ---- -
-MIT License · Built by [Hawksight AI](https://github.com/Hawksight-AI) +MIT License · Built by [Semantica](https://github.com/semantica-agi) -[GitHub](https://github.com/Hawksight-AI/semantica)  ·  +[GitHub](https://github.com/semantica-agi/semantica)  ·  [Discord](https://discord.gg/sV34vps5hH)  ·  [Twitter/X](https://x.com/BuildSemantica)  ·  [Website](https://getsemantica.ai/)  ·  @@ -1085,8 +1013,8 @@ MIT License · Built by [Hawksight AI](https://github.com/Hawksight-AI) If this project helps you build better AI, a star means a lot. -**[⭐ Star on GitHub →](https://github.com/Hawksight-AI/semantica)** +**[⭐ Star on GitHub →](https://github.com/semantica-agi/semantica)** -[English](https://readme-i18n.com/Hawksight-AI/semantica?lang=en) · [Deutsch](https://readme-i18n.com/Hawksight-AI/semantica?lang=de) · [Français](https://readme-i18n.com/Hawksight-AI/semantica?lang=fr) · [Español](https://readme-i18n.com/Hawksight-AI/semantica?lang=es) · [Italiano](https://readme-i18n.com/Hawksight-AI/semantica?lang=it) · [Português](https://readme-i18n.com/Hawksight-AI/semantica?lang=pt) · [العربية](https://readme-i18n.com/Hawksight-AI/semantica?lang=ar) · [اردو](https://readme-i18n.com/Hawksight-AI/semantica?lang=ur) · [हिन्दी](https://readme-i18n.com/Hawksight-AI/semantica?lang=hi) · [中文](https://readme-i18n.com/Hawksight-AI/semantica?lang=zh) · [日本語](https://readme-i18n.com/Hawksight-AI/semantica?lang=ja) · [한국어](https://readme-i18n.com/Hawksight-AI/semantica?lang=ko) +[English](https://readme-i18n.com/semantica-agi/semantica?lang=en) · [Deutsch](https://readme-i18n.com/semantica-agi/semantica?lang=de) · [Français](https://readme-i18n.com/semantica-agi/semantica?lang=fr) · [Español](https://readme-i18n.com/semantica-agi/semantica?lang=es) · [Italiano](https://readme-i18n.com/semantica-agi/semantica?lang=it) · [Português](https://readme-i18n.com/semantica-agi/semantica?lang=pt) · [العربية](https://readme-i18n.com/semantica-agi/semantica?lang=ar) · [اردو](https://readme-i18n.com/semantica-agi/semantica?lang=ur) · [हिन्दी](https://readme-i18n.com/semantica-agi/semantica?lang=hi) · [中文](https://readme-i18n.com/semantica-agi/semantica?lang=zh) · [日本語](https://readme-i18n.com/semantica-agi/semantica?lang=ja) · [한국어](https://readme-i18n.com/semantica-agi/semantica?lang=ko)