diff --git a/README.md b/README.md index c1b2f68c..1eaec608 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ Semantica is the **context and intelligence layer** you add on top of your exist - ✅ **Reasoning Engines** — forward chaining, Rete networks, deductive, abductive, and SPARQL. Explainable paths, not black boxes. - ✅ **Quality & Deduplication** — conflict detection, entity resolution, and pipeline validation built in. -> Works alongside LangChain, LlamaIndex, AutoGen, CrewAI, and any LLM — Semantica is the **accountability layer** on top, not a replacement. +> Works alongside **Agno** and any LLM — Semantica is the **accountability layer** on top, not a replacement. LangChain, LangGraph, CrewAI, and more coming soon. ```bash pip install semantica @@ -170,6 +170,75 @@ Semantica ships **native plugin bundles** for Claude Code, Cursor, and Codex, an +### Agentic Frameworks + +Semantica integrates with **Agno** today. Coming soon: LangChain, LangGraph, CrewAI, LlamaIndex, AutoGen, OpenAI Agents SDK, Google ADK, and more. + + + + + + + + + + + + + + + + + + + + +
✅ Supported
+Agno
+Agno
+First-class · pip install semantica[agno] +
🔜 Coming Soon
+LangChain
+LangChain
+Coming soon +		 +LangGraph
+LangGraph
+Coming soon +		 +CrewAI
+CrewAI
+Coming soon +		 +LlamaIndex
+LlamaIndex
+Coming soon +		 +AutoGen
+AutoGen
+Coming soon +		 +OpenAI Agents SDK
+OpenAI Agents
+Coming soon +		 +Google ADK
+Google ADK
+Coming soon +
+ +> **Agno — First-Class Integration** · `pip install semantica[agno]` +> +> Five integration modules live in [`integrations/agno/`](integrations/agno/): +> +> | Module | Class | What it does | +> |---|---|---| +> | `context_store.py` | `AgnoContextStore` | Graph-backed agent memory — store and retrieve structured context | +> | `knowledge_graph.py` | `AgnoKnowledgeGraph` | Implements Agno's `AgentKnowledge` protocol; full extraction pipeline | +> | `decision_kit.py` | `AgnoDecisionKit` | 6 decision-intelligence tools for Agno agents | +> | `kg_toolkit.py` | `AgnoKGToolkit` | 7 KG pipeline tools (build, query, enrich, export) | +> | `shared_context.py` | `AgnoSharedContext` | Shared context graph for multi-agent team coordination | + ### Plugin Bundles (Claude Code · Cursor · Codex) Native plugin bundles live under [`plugins/`](plugins/). Each directory contains a `plugin.json`, `marketplace.json`, and `README.md`. @@ -875,53 +944,6 @@ if result.valid: - **`semantica.llms`** — Groq, OpenAI, Novita AI, HuggingFace, LiteLLM - **[`explorer/`](explorer/)** — **Semantica Knowledge Explorer** — browser UI for live graph inspection, decisions, entity resolution, and ontology browsing (`npm run dev` in `explorer/`) - ---- - -## 🔌 Integrations - -### AI Coding Tools & IDEs - -Start the Semantica server (`python -m semantica.server`, port 8000) and point any tool at `http://localhost:8000`. Tools marked **Native plugin** also get 17 skills, 3 agents, and hook config out of the box. - -| Tool | Connection | Notes | -|---|---|---| -| [Claude Code](https://claude.com/product/claude-code) | **Native plugin** | `plugins/.claude-plugin/` — 17 skills, 3 agents, `hooks.json` | -| [Cursor](https://cursor.com) | **Native plugin** | `plugins/.cursor-plugin/` — same 17 skills + 3 agents | -| [Codex CLI](https://github.com/openai/codex) | **Native plugin** | `plugins/.codex-plugin/` — same 17 skills + 3 agents | -| [Windsurf](https://windsurf.com) | **MCP server** + plugin | `plugins/.windsurf-plugin/` · add `python -m semantica.mcp_server` to `~/.codeium/windsurf/mcp_config.json` | -| [Claude Desktop](https://claude.ai/download) | **MCP server** | Add `python -m semantica.mcp_server` to `claude_desktop_config.json` | -| [VS Code](https://github.com/microsoft/vscode) | **MCP server** + plugin | `plugins/.vscode-plugin/` · add to `settings.json` under `mcp.servers` | -| [GitHub Copilot](https://github.com/features/copilot) | REST API | Use via Copilot Chat custom tools | -| [Cline](https://github.com/cline/cline) | **MCP server** + plugin | `plugins/.cline-plugin/` · add server in Cline MCP settings panel | -| [Roo Code](https://github.com/RooCodeInc/Roo-Code) | **MCP server** | Add `python -m semantica.mcp_server` in Roo Code MCP settings | -| [Continue](https://github.com/continuedev/continue) | **MCP server** + plugin | `plugins/.continue-plugin/` · add to `~/.continue/config.json` under `mcpServers` | -| [Goose](https://github.com/block/goose) | REST API | Add to Goose toolset config | -| [Kilo Code](https://github.com/Kilo-Org/kilocode) | REST API | Add as custom REST tool | -| [Aider](https://github.com/Aider-AI/aider) | REST API | Pass context from the API into prompts | -| [Amazon Q Developer](https://github.com/aws/amazon-q-developer-cli) | REST API | Use via Q Developer custom tools | -| [Zed](https://zed.dev) | REST API | Integrate via Zed assistant context | -| Any agent | REST API | 109 endpoints — drop-in with any HTTP client | - -### REST API Server - -Run `python -m semantica.server` (or `python -m semantica`) — FastAPI on port 8000 with the following route groups: - -| Route group | Module | Endpoints | -|---|---|---| -| `/api/graph` | `routes/graph.py` | Nodes, edges, traversal, graph topology | -| `/api/analytics` | `routes/analytics.py` | Centrality, communities, metrics | -| `/api/decisions` | `routes/decisions.py` | Decision CRUD, precedent search, causal chains | -| `/api/temporal` | `routes/temporal.py` | Point-in-time queries, snapshots, timelines | -| `/api/export` | `routes/export_import.py` | Import/export in RDF, Parquet, JSON, CSV, GraphML | -| `/api/annotations` | `routes/annotations.py` | Entity and edge annotation | -| `/api/enrich` | `routes/enrich.py` | Graph enrichment — embeddings, vectors, metadata | -| `/api/sparql` | `routes/sparql.py` | SPARQL query execution | -| `/api/provenance` | `routes/provenance.py` | Data lineage and audit trails | -| `/api/vocabulary` | `routes/vocabulary.py` | Ontology, SKOS concepts, schema definitions | -| `/ws` | `ws.py` | WebSocket — real-time graph mutation events | -| `/health` | `server.py` | Health check | - ### Graph Databases - **Neo4j** — Cypher queries via `semantica.graph_store` - **FalkorDB** — native support; `DecisionQuery` and `CausalChainAnalyzer` work directly with FalkorDB row/header shapes @@ -952,67 +974,6 @@ Run `python -m semantica.server` (or `python -m semantica`) — FastAPI on port - **HuggingFace** — local and hosted models via `HuggingFaceProvider` - **Ollama** — local models including remote server support -### Agentic Frameworks - -Semantica complements — not replaces — every major agentic framework. Use it as the accountability layer on top. - - - - - - - - - - - - -
-Agno
-Agno
-First-class · pip install semantica[agno] -		 -LangChain
-LangChain
-Context layer -		 -LangGraph
-LangGraph
-Stateful agent graph -		 -LlamaIndex
-LlamaIndex
-GraphRAG retriever -		 -AutoGen
-AutoGen
-Shared context graph -		 -CrewAI
-CrewAI
-Decision + provenance -		 -OpenAI Agents SDK
-OpenAI Agents
-Context + KG tools -		 -Google ADK
-Google ADK
-Context layer -
- -> **Agno — First-Class Integration** · `pip install semantica[agno]` -> -> Five integration modules live in [`integrations/agno/`](integrations/agno/): -> -> | Module | Class | What it does | -> |---|---|---| -> | `context_store.py` | `AgnoContextStore` | Graph-backed agent memory — store and retrieve structured context | -> | `knowledge_graph.py` | `AgnoKnowledgeGraph` | Implements Agno's `AgentKnowledge` protocol; full extraction pipeline | -> | `decision_kit.py` | `AgnoDecisionKit` | 6 decision-intelligence tools for Agno agents | -> | `kg_toolkit.py` | `AgnoKGToolkit` | 7 KG pipeline tools (build, query, enrich, export) | -> | `shared_context.py` | `AgnoSharedContext` | Shared context graph for multi-agent team coordination | - --- ## 🛠️ Installation