LLM Wiki by Karpathy — Docker / Portainer Deployment

A Docker-based deployment of Andrej Karpathy's LLM Wiki pattern.

A persistent, compounding knowledge base maintained by LLM agents. You curate sources and ask questions — the LLM does all the bookkeeping.

Architecture

llm-wiki/
├── docker-compose.yml       # Portainer-compatible stack
├── mkdocs.yml               # MkDocs configuration (nav, theme, plugins)
├── .env.example             # Environment variables
├── docs/docs/
│   ├── index.md             # Home page
│   ├── wiki/                # LLM-maintained content pages
│   │   ├── index.md         # Wiki index
│   │   ├── entities/        # Entity pages (people, places, systems)
│   │   ├── concepts/        # Concept pages
│   │   ├── comparisons/     # Comparison pages
│   │   └── syntheses/       # Integrated overviews
│   ├── sources/             # Ingested source summaries
│   ├── raw/                 # Raw source files (immutable)
│   ├── schema/              # AGENTS.md (schema for the LLM agent)
│   └── log.md               # Append-only changelog
└── schema/
    └── AGENTS.md            # Master schema file (paste to your LLM agent)

Deployment

Portainer (recommended)

Copy the docker-compose.yml content
Portainer → Stacks → Add Stack → Web Editor
Paste the compose content
Stack name: llm-wiki
Environment variables (optional):
- WIKI_PORT=8787
Click Deploy the stack

Docker Compose CLI

cp .env.example .env
docker compose up -d

Then visit http://:8787

How to Use

1. Add content

Drop markdown files into docs/docs/raw/ — articles, notes, papers, etc.

2. Tell your LLM agent

Give your LLM agent (Hermes, Claude Code, Codex) the AGENTS.md schema:

"Here is my LLM Wiki schema: [paste schema/AGENTS.md]. Please read raw/ and ingest the new sources."

3. Explore

Browse the wiki at http://:8787 — search, follow links, see the structure grow.

4. Lint

Periodically ask your agent to health-check the wiki for contradictions, orphans, and gaps.

Credits

Andrej Karpathy — original LLM Wiki concept
MkDocs Material — wiki viewer theme

2.4 KiB Raw Permalink Blame History