← all repositories
kytmanov/obsidian-llm-wiki-local

Your notes, ghostwritten by a local LLM that actually remembers

A Python pipeline turns raw Markdown into a self-linking Obsidian wiki using Ollama — no cloud, no vector DB, no forgotten conversations.

785 stars Python RAG · SearchLLMOps · Eval
obsidian-llm-wiki-local
Not currently ranked — collecting fresh signals.
star history

What it does

obsidian-llm-wiki is a Python CLI that ingests Markdown files from a raw/ folder, uses a local LLM (Ollama by default) to extract concepts, and generates interlinked wiki articles inside an Obsidian vault. It compiles incrementally, preserves hand-edits, and can answer questions from your accumulated knowledge without embeddings or a vector database.

The interesting bit

The project implements Andrej Karpathy’s “LLM Wiki” pattern: notes are treated as source material, not final artifacts. The LLM does the bookkeeping — cross-referencing, updating, and linking — while you just keep dumping in raw thoughts. Reject a draft with feedback and the next compile incorporates your critique; five rejections auto-blocks a concept until you intervene. It’s a rare case where “the AI remembers” isn’t marketing fluff because the wiki literally persists as Markdown on disk.

Key highlights

  • Fully local-first — Ollama by default, with optional OpenAI-compatible endpoints (Groq, Together, vLLM, etc.)
  • Incremental compiles — only articles linked to changed source notes get rebuilt
  • File watcherolw watch auto-processes anything dropped into raw/
  • Hand-edit protection — detects manual changes in Obsidian and skips regeneration
  • Query without embeddingsolw query answers from the published wiki; --synthesize saves answers as permanent pages
  • Self-maintenance — auto-extracts aliases, repairs broken wikilinks, lints orphans, and commits every action with [olw] prefix for olw undo
  • Multi-language — auto-detects note language at ingest, no hard-coded word lists

Caveats

  • Maintenance mode — new features moved to successor project Synto; this repo gets bug fixes only
  • Requires model management — you need to pull and configure separate “fast” (routing) and “heavy” (writing) models; minimal setup works with one model but quality likely suffers
  • Obsidian-centric — the wiki structure and wikilinks are designed specifically for Obsidian; other tools may struggle with the conventions

Verdict

Worth a look if you’re an Obsidian user sitting on piles of unstructured Markdown who wants a private, compounding knowledge base without subscription APIs or cloud vector stores. Skip it if you don’t use Obsidian or need actively maintained feature development — the author has already moved on to Synto.

Frequently asked

What is kytmanov/obsidian-llm-wiki-local?
A Python pipeline turns raw Markdown into a self-linking Obsidian wiki using Ollama — no cloud, no vector DB, no forgotten conversations.
Is obsidian-llm-wiki-local open source?
Yes — kytmanov/obsidian-llm-wiki-local is open source, released under the MIT license.
What language is obsidian-llm-wiki-local written in?
kytmanov/obsidian-llm-wiki-local is primarily written in Python.
How popular is obsidian-llm-wiki-local?
kytmanov/obsidian-llm-wiki-local has 785 stars on GitHub.
Where can I find obsidian-llm-wiki-local?
kytmanov/obsidian-llm-wiki-local is on GitHub at https://github.com/kytmanov/obsidian-llm-wiki-local.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.