How axoviq-ai/synthadoc works
Synthadoc is a domain-agnostic LLM wiki engine: users submit documents or questions through CLI, web, Obsidian, or MCP interfaces; agents synthesize and retrieve knowledge, and the wiki persists as Markdown with citations. The graph preserves documented maintenance, cross-wiki, skill, and integration capabilities. Source excerpts and the README support the main relationships; unsampled subsystem internals are represented at their exact tree paths, with uncertain links omitted.
Main entry points: query_agent.py Question Answering · ingest_agent.py Document Ingest · http_server.py HTTP Server · main.py CLI
Components 18
User Interfaces
- CLI
synthadoc/cli/main.py - Web UI
web-ui/src/App.tsx - Obsidian Plugin
obsidian-plugin/src/main.ts - MCP Server
synthadoc/integration/mcp_server.py - HTTP Server
synthadoc/integration/http_server.py
Knowledge Agents
- Document Ingest
synthadoc/agents/ingest_agent.py - Question Answering
synthadoc/agents/query_agent.py - Wiki Lint
synthadoc/agents/lint_agent.py - Cross-Wiki Query
synthadoc/agents/cross_wiki_query_agent.py - Maintenance Workflows
synthadoc/agents/workflows - Document Skills
synthadoc/skills
Core Platform
- LLM Providers
synthadoc/providers/base.py - Routing Index
synthadoc/core/routing.py - Wiki Templates
synthadoc/templates
Wiki State
- Markdown Wiki
synthadoc/storage/wiki.py - Hybrid Search
synthadoc/storage/search.py - Audit and Logs
synthadoc/storage/log.py
Other components
- User
Connections 28
- User → CLI: submits sources
README.md - User → Web UI: asks questions
README.md - User → Obsidian Plugin: uses wiki
README.md - User → MCP Server: connects tools
README.md - CLI → Document Ingest: ingests documents
README.md - CLI → Question Answering: asks questions
README.md - Web UI → HTTP Server: calls API
- Obsidian Plugin → HTTP Server: calls API
- MCP Server → HTTP Server: integrates server
synthadoc/integration/http_server.py - HTTP Server → Question Answering: serves queries
- HTTP Server → Document Ingest: accepts ingestion
synthadoc/integration/http_server.py - Document Ingest → LLM Providers: requests synthesis
synthadoc/agents/ingest_agent.py - Question Answering → LLM Providers: requests answers
synthadoc/agents/query_agent.py - Document Ingest → Document Skills: extracts sources
synthadoc/agents/ingest_agent.py - Document Ingest → Markdown Wiki: writes pages
synthadoc/agents/ingest_agent.py - Document Ingest → Hybrid Search: indexes pages
synthadoc/agents/ingest_agent.py - Document Ingest → Audit and Logs: records activity
synthadoc/agents/ingest_agent.py - Question Answering → Hybrid Search: retrieves pages
synthadoc/agents/query_agent.py - Question Answering → Markdown Wiki: reads pages
synthadoc/agents/query_agent.py - Question Answering → Audit and Logs: records activity
synthadoc/agents/query_agent.py - Wiki Lint → Markdown Wiki: checks pages
synthadoc/agents/lint_agent.py - Wiki Lint → LLM Providers: checks claims
synthadoc/agents/lint_agent.py - Cross-Wiki Query → Question Answering: queries wikis
synthadoc/agents/cross_wiki_query_agent.py - Cross-Wiki Query → CLI: resolves wiki
synthadoc/agents/cross_wiki_query_agent.py - Maintenance Workflows → Wiki Lint: runs maintenance
synthadoc/agents/workflows/ingest_lint.py - Question Answering → Routing Index: loads branches
synthadoc/agents/query_agent.py - User → Wiki Templates: starts wiki
README.md - Markdown Wiki → User: provides Markdown
README.md