Karpathy LLM Wiki - Docker/Portainer stack
Go to file
2026-06-16 18:32:05 +02:00
docs Initial: LLM Wiki stack 2026-06-16 16:04:26 +00:00
schema Initial: LLM Wiki stack 2026-06-16 16:04:26 +00:00
.env.example Initial: LLM Wiki stack 2026-06-16 16:04:26 +00:00
docker-compose.yml docker-compose.yml aktualisiert 2026-06-16 18:32:05 +02:00
Dockerfile Initial: LLM Wiki stack 2026-06-16 16:04:26 +00:00
mkdocs.yml Initial: LLM Wiki stack 2026-06-16 16:04:26 +00:00
README.md Initial: LLM Wiki stack 2026-06-16 16:04:26 +00:00

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

  1. Copy the docker-compose.yml content
  2. Portainer → Stacks → Add Stack → Web Editor
  3. Paste the compose content
  4. Stack name: llm-wiki
  5. Environment variables (optional):
    • WIKI_PORT=8787
  6. 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