$git clone https://github.com/lucasastorian/llmwikiAn autonomous, self-maintaining personal Wikipedia built and maintained by AI.
| 1 | # LLM Wiki |
| 2 | |
| 3 | **An autonomous, self-maintaining personal Wikipedia built and maintained by AI.** |
| 4 | |
| 5 | [](https://opensource.org/licenses/Apache-2.0) |
| 6 | |
| 7 | </div> |
| 8 | |
| 9 | LLM Wiki transforms your scattered reading and research into a persistent, AI-maintained second brain. Capture documents, notes, and web clippings as you work, and deploy a nightly Claude Routine to autonomously synthesize those sources into a permanent knowledge base. Because the clipper captures your highlights and margin notes alongside the source, the wiki becomes a record of not just what you read but what you *thought* about it — one that compounds over months and years, long after the original context would have faded. This architecture is heavily inspired by [Andrej Karpathy's LLM Wiki concept](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f), with an increased emphasis on autonomous maintenance. |
| 10 | |
| 11 | <p align="center"> |
| 12 | <img src="wiki-page.png" alt="LLM Wiki — a compiled wiki page with citations and table of contents" width="820" /> |
| 13 | </p> |
| 14 | |
| 15 | |
| 16 | LLM Wiki is designed to work at three distinct scales: |
| 17 | |
| 18 | - **For you** — a personal Wikipedia of what you've read that you don't have to remember to update. |
| 19 | - **For your AI** — a context layer for LLMs to apply your own mental models when working with you. |
| 20 | - **For your organization** — most organizations have poor institutional memory, because know-how generally lives in people's heads. We hope companies will consider adopting this model to build a self-maintaining institutional knowledge layer. |
| 21 | |
| 22 | # Features |
| 23 | |
| 24 | - **Connect via MCP** Connect Claude.ai, Claude Cowork, Claude Code, or Codex (or any other MCP-compatible app) |
| 25 | - **A Chrome extension** Clip webpages and PDFs as you read, highlight key sections, and leave comments that Claude can see over MCP. |
| 26 | - **Uploads** Markdown, PowerPoint, PDFs, Word documents, and more. |
| 27 | - **A clean Next.js web app** to navigate your own wikipedia — and view the underlying sources. |
| 28 | - **Native cross-linking** between wiki pages, and back to the sources they came from. |
| 29 | - **A graph viewer** to see how your concepts and entities relate. |
| 30 | - **Visualizations** — Charts and other visualizations, including SVGs and Mermaid diagrams. |
| 31 | |
| 32 | # Getting started |
| 33 | |
| 34 | LLM Wiki supports two modes: remote & local. You can self-host the remote app, or try it out for free at llmwiki.app. Or you can git clone the repository, and use the CLI to get started. |
| 35 | |
| 36 | Here's how to get started locally. |
| 37 | |
| 38 | **Requirements:** Python 3.11+, Node.js 20+. Optional: [LibreOffice](https://www.libreoffice.org/) to extract Word/PowerPoint files, and a `MISTRAL_API_KEY` for higher-quality PDF OCR. |
| 39 | |
| 40 | **1. Install.** Clone the repo and install the Python and web dependencies. |
| 41 | |
| 42 | ```bash |
| 43 | git clone https://github.com/lucasastorian/llmwiki.git |
| 44 | cd llmwiki |
| 45 | python -m venv .venv && source .venv/bin/activate |
| 46 | pip install -r api/requirements.txt -r mcp/requirements.txt |
| 47 | cd web && npm install && cd .. |
| 48 | ``` |
| 49 | |
| 50 | **2. Point it at a folder of your files** — PDFs, Word documents, PowerPoints, Markdown, notes. LLM Wiki indexes them into a local search index so they show up in the app and Claude can read them. Your files stay where they are; nothing is moved or uploaded. |
| 51 | |
| 52 | ```bash |
| 53 | ./llmwiki open ~/research |
| 54 | ``` |
| 55 | |
| 56 | This initializes the workspace, indexes the folder, starts the API and web app, and opens [localhost:3000](http://localhost:3000). |
| 57 | |
| 58 | **3. Connect Claude over MCP.** MCP enables Claude to read, write, and search your wiki. |
| 59 | |
| 60 | ```bash |
| 61 | ./llmwiki mcp-config ~/research |
| 62 | ``` |
| 63 | |
| 64 | Paste the printed JSON into `claude_desktop_config.json` (Claude Desktop) or `.claude/settings.json` (Claude Code). One workspace is one MCP server entry, so add one per folder. Then tell Claude: *"Read the guide, then ingest my sources and start building the wiki."* |
| 65 | |
| 66 | **4. Make it self-maintaining.** Set up a Claude Routine — a scheduled prompt that runs on its own — so Claude refreshes the wiki without you having to remember to. Each run |