my-llm-wiki

Drop any files into a folder. Get a living, queryable knowledge graph.

Documentation · Issues

In April 2026, Andrej Karpathy shared a concept he called LLM Wiki — a personal knowledge system with three layers: raw files (never modified), a compiled wiki with cross-references, and a schema that tells the LLM how to maintain it. The key insight: compile once, query forever, and let the wiki grow with every session as a "persistent, compounding artifact" rather than re-deriving knowledge on every query.

my-llm-wiki implements all three layers.

pip install my-llm-wiki
cd your-project && llm-wiki .

The output wiki-out/vault/ is a drop-in Obsidian vault — open it directly, or query from CLI. Re-run anytime; SHA256 cache skips unchanged files. llm-wiki note "<insight>" writes back from your Claude Code sessions so the graph compounds over time.

Supported file types

• Code (19 languages) — Python, TypeScript/JavaScript, Go, Rust, Java, C/C++, Ruby, C#, and more (full list). Tree-sitter AST: classes, functions, typed extends/implements, function signatures, doc comments (Javadoc / JSDoc / GoDoc / ///), call graph.
• Markdown / text — headings, definitions, [[wikilinks]], cross-document references.
• PDF / DOCX / PPTX / HTML / EPUB — layout-aware extraction via Docling (pip install 'my-llm-wiki[docling]'). Headings + tables preserved. Scanned PDFs auto-OCR. EPUB unpacked via stdlib zipfile and routed through Docling's HTML pipeline. Bold-as-heading fallback for documents without Word Heading styles.
• Images (HEIC / PNG / JPG) — hub nodes from structural pass; vision OCR via Claude Code agent mode (/wiki .).

Read the docs

The full story lives at phuc-nt.github.io/my-llm-wiki:

• How It's Built — narrative: Karpathy's vision → three layers → the living wiki cycle
• Install & Quick Start — first graph in 30 seconds
• Core Features — two-pass extraction, typed inheritance, doc comments, communities, write-back
• How It Works — pipeline internals
• Use Cases — codebases, research notes, mixed knowledge

License

MIT