How samuraigpt/llm-wiki-agent works
LLM Wiki Agent is an agent-operated knowledge system: users submit source documents, which are converted when needed and ingested into linked wiki pages; queries synthesize answers from that accumulated knowledge. Separate workflows refresh stale sources, inspect wiki health, repair missing entity pages, and build an interactive graph. The README documents additional supported formats and graph features; sampled excerpts do not expose every internal call, so uncertain wiring is omitted.
Main entry points: wiki Wiki Pages · query.py Query Wiki · ingest.py Ingest Sources · build_graph.py Build Knowledge Graph
Components 17
Source Ingestion
- PDF Converter
tools/pdf2md.py - Ingest Sources
tools/ingest.py - Raw Documents
raw
Persistent Wiki
- Wiki Pages
wiki - Shared Utilities
tools/_utils.py
Knowledge Exploration
- Query Wiki
tools/query.py - Query Answer
- Build Knowledge Graph
tools/build_graph.py - Graph Data
graph - Interactive Graph
tools/build_graph.py
Wiki Maintenance
- Refresh Sources
tools/refresh.py - Lint Wiki
tools/lint.py - Structural Health
tools/health.py - Heal Entity Pages
tools/heal.py - Health Reports
wiki
Other components
- User / Agent
- LLM Service
Connections 34
- User / Agent → Raw Documents: adds documents
- User / Agent → Ingest Sources: requests ingest
- User / Agent → PDF Converter: requests conversion
- PDF Converter → Raw Documents: writes Markdown
- Ingest Sources → Raw Documents: reads sources
- Ingest Sources → Wiki Pages: writes wiki pages
- Ingest Sources → LLM Service: requests extraction
- Ingest Sources → Shared Utilities: uses helpers
- User / Agent → Query Wiki: asks question
- Query Wiki → Wiki Pages: reads relevant pages
- Query Wiki → Graph Data: reads related links
- Query Wiki → LLM Service: requests synthesis
- Query Wiki → Query Answer: returns answer
- Query Wiki → Wiki Pages: saves synthesis
- User / Agent → Build Knowledge Graph: requests graph
- Build Knowledge Graph → Wiki Pages: reads wiki links
- Build Knowledge Graph → LLM Service: infers relationships
- Build Knowledge Graph → Graph Data: writes graph
- Build Knowledge Graph → Interactive Graph: generates visualization
- User / Agent → Refresh Sources: requests refresh
- Refresh Sources → Raw Documents: checks source changes
- Refresh Sources → Ingest Sources: re-ingests stale source
- User / Agent → Lint Wiki: requests lint
- Lint Wiki → Wiki Pages: checks wiki pages
- Lint Wiki → Graph Data: checks graph structure
- Lint Wiki → LLM Service: checks semantic gaps
- User / Agent → Structural Health: requests health check
- Structural Health → Wiki Pages: checks consistency
- Structural Health → Health Reports: writes report
- User / Agent → Heal Entity Pages: requests repair
- Heal Entity Pages → Wiki Pages: reads page context
- Heal Entity Pages → LLM Service: generates entity pages
- Heal Entity Pages → Shared Utilities: uses wiki helpers
- Heal Entity Pages → Wiki Pages: writes entity pages