Unlike RAG systems that re-derive answers from raw sources on every query, Axiom compiles knowledge into an interconnected wiki of markdown pages and keeps it current as new sources arrive. Inspired by Andrej Karpathy's llm-wiki.

Quick Start

npm install -g axiom-wiki
axiom-wiki init

The setup wizard configures your LLM provider, wiki directory, and source folder. Then drop files into raw/ and ingest:

axiom-wiki ingest

Or auto-wiki a project folder:

axiom-wiki autowiki

Launch the interactive shell:

axiom-wiki

See the full documentation for detailed guides.

Supported LLM Providers

| Provider | Free Tier | Get API Key | |---|---|---| | Google Gemini (recommended) | Yes | aistudio.google.com | | OpenAI | No | platform.openai.com | | Anthropic | No | console.anthropic.com | | Ollama (local) | Free | ollama.com |

Commands

axiom-wiki                    Launch interactive shell
axiom-wiki init               First-time setup wizard
axiom-wiki ingest [file|url]  Ingest a file, URL, or scan raw/
axiom-wiki query              Chat against your wiki
axiom-wiki autowiki           Agent explores and builds a wiki
axiom-wiki sync               Agent updates stale wiki pages
axiom-wiki watch              Auto-ingest new files in raw/
axiom-wiki clip [url]         Clip a URL to raw/
axiom-wiki sources            Manage ingested sources
axiom-wiki review             Resolve wiki contradictions
axiom-wiki graph              Visualize the wiki page graph
axiom-wiki model              Switch LLM provider or model
axiom-wiki status             Wiki statistics
axiom-wiki mcp                Start MCP server (Claude Code / Cursor)

axwiki is an alias for axiom-wiki.

Key Features

Ingest documents — Drop PDFs, markdown, images, DOCX, or HTML into raw/. The agent extracts entities, concepts, and creates cross-linked wiki pages. Docs

Auto-wiki anything — axiom-wiki autowiki lets an AI agent autonomously explore your project or document folder, decide what pages to create, and build a comprehensive wiki in batches. Works on codebases, company docs, personal notes — the agent adapts to the content. Docs

Incremental compilation — Source files are tracked by SHA-256 hash. Re-running axiom-wiki ingest skips unchanged files and only processes new or modified sources — fast even on large wikis.

Incremental sync — axiom-wiki sync detects changes and lets the agent update stale pages and document new areas. Docs

Local project wikis — Scope a wiki to a single project inside .axiom/. Auto-detected, no flags needed. Docs

Web clipper — axiom-wiki clip <url> fetches articles via Readability and saves them for ingest. Docs

MCP integration — Use all wiki tools from Claude Code or Cursor. Docs

Obsidian compatible — Plain markdown with frontmatter. Open wiki/ as a vault. Docs

Cost tracking — Every operation logs tokens and cost to wiki/usage.log. Docs

Installation

npm install -g axiom-wiki    # or: yarn, pnpm
npx axiom-wiki init          # run without installing

From source:

git clone https://github.com/abubakarsiddik31/axiom-wiki.git
cd axiom-wiki && pnpm install && pnpm build && pnpm link --global

Docker:

docker run -it -v $(pwd):/wiki axiomwiki/axiom-wiki init

See Installation docs for Docker Compose and Ollama setup.

Wiki Structure

For local wikis (inside a project), everything lives in .axiom/:

.axiom/
  config.json           Local config
  state.json            Compilation state (source hashes)
  map-state.json        Autowiki/sync state
  raw/                  Source files (PDF, MD, DOCX, images, HTML)
  wiki/
    pages/
      entities/         People, places, organisations
      concepts/         Ideas, topics, theories
      sources/          One summary per source file
      analyses/         Filed answers, comparisons
    index.md            Page catalog
    log.md              Operation history
    usage.log           Token usage and cost

Sponsoring

Axiom Wiki is free and open source. If it saves you time, consider supporting development:

• GitHub Sponsors — recurring or one-time
• Ko-fi — buy me a coffee
• Open Collective — transparent, supports teams

Contributing

PRs are welcome. See CONTRIBUTING.md for the full guide.

• Report a bug
• Request a feature
• Good first issues

License

Elastic License 2.0 (ELv2) — Free to use, self-host, and modify. See LICENSE for details.

Axiom Wiki — The wiki that maintains itself.