mengzhx/semantica
1
0
Fork 0
mirror of https://github.com/semantica-agi/semantica.git synced 2026-08-29 04:26:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(readme): remove dividers, rebrand to semantica-agi org (#612)

Browse Source 
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.
This commit is contained in:
Mohd Kaif
2026-06-11 21:14:12 +05:30
committed by GitHub
parent dba24c6ddb
commit 0dfdf66f82
1 changed files with 11 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+11 -83
View File
@@ -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 @@
</div>
---
> 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)** &nbsp;·&nbsp; **[Why Semantica](#why-semantica)** &nbsp;·&nbsp; **[Architecture](#architecture)** &nbsp;·&nbsp; **[Context Graphs](#context-graphs)** &nbsp;·&nbsp; **[Decision Intelligence](#decision-intelligence)** &nbsp;·&nbsp; **[Module Showcase](#module-showcase)** &nbsp;·&nbsp; **[CLI](#cli)** &nbsp;·&nbsp; **[Integrations](#integrations)** &nbsp;·&nbsp; **[Performance](#performance)** &nbsp;·&nbsp; **[Install](#installation)**
---
## See It in Action
<div align="center">
@@ -65,8 +59,6 @@
</div>
---
## 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)** &nbsp;·&nbsp; **[Join Discord](https://discord.gg/sV34vps5hH)**
**[⭐ Star on GitHub](https://github.com/semantica-agi/semantica)** &nbsp;·&nbsp; **[Join Discord](https://discord.gg/sV34vps5hH)**
</div>
---
## 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
<a href="https://www.star-history.com/?repos=semantica-agi%2Fsemantica&type=date&legend=top-left">
@@ -1047,8 +981,6 @@ On-premises deployment · Private cloud · Custom domain implementations · SLA-
</picture>
</a>
---
## Contributors
<div align="center">
@@ -1057,8 +989,6 @@ On-premises deployment · Private cloud · Custom domain implementations · SLA-
</div>
---
## 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.
---
<div align="center">
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) &nbsp;·&nbsp;
[GitHub](https://github.com/semantica-agi/semantica) &nbsp;·&nbsp;
[Discord](https://discord.gg/sV34vps5hH) &nbsp;·&nbsp;
[Twitter/X](https://x.com/BuildSemantica) &nbsp;·&nbsp;
[Website](https://getsemantica.ai/) &nbsp;·&nbsp;
@@ -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)
</div>