{"id":49851674,"url":"https://github.com/inferis995/llm-wiki-portable","last_synced_at":"2026-05-14T16:37:02.865Z","repository":{"id":356490356,"uuid":"1232400036","full_name":"inferis995/llm-wiki-portable","owner":"inferis995","description":"AI-powered knowledge base on a USB stick. 3D graph, markdown wikilinks, works with Claude Code \u0026 OpenCode. Zero install, fully portable.","archived":false,"fork":false,"pushed_at":"2026-05-08T08:51:33.000Z","size":686,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-08T10:40:08.089Z","etag":null,"topics":["3d-graph","ai","claude-code","knowledge-base","markdown","offline","opencode","personal-knowledge-base","portable","second-brain","usb","wiki"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/inferis995.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-07T22:31:12.000Z","updated_at":"2026-05-08T08:51:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/inferis995/llm-wiki-portable","commit_stats":null,"previous_names":["inferis995/llm-wiki-portable"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/inferis995/llm-wiki-portable","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferis995%2Fllm-wiki-portable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferis995%2Fllm-wiki-portable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferis995%2Fllm-wiki-portable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferis995%2Fllm-wiki-portable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/inferis995","download_url":"https://codeload.github.com/inferis995/llm-wiki-portable/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/inferis995%2Fllm-wiki-portable/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33033380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-graph","ai","claude-code","knowledge-base","markdown","offline","opencode","personal-knowledge-base","portable","second-brain","usb","wiki"],"created_at":"2026-05-14T16:37:02.087Z","updated_at":"2026-05-14T16:37:02.858Z","avatar_url":"https://github.com/inferis995.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LLM Wiki Portable\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"screenshot.webp\" alt=\"LLM Wiki Portable — 3D Knowledge Graph\" width=\"700\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://llm-wiki-lyart.vercel.app/\"\u003e\u003cimg src=\"https://img.shields.io/badge/demo-live-7c3aed?style=flat\u0026logo=vercel\u0026logoColor=white\" alt=\"Live Demo\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/inferis995/llm-wiki-portable/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/inferis995/llm-wiki-portable?style=social\" alt=\"Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/inferis995/llm-wiki-portable/blob/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/inferis995/llm-wiki-portable?color=blue\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/inferis995/llm-wiki-portable?color=orange\" alt=\"Last Commit\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/repo-size/inferis995/llm-wiki-portable?color=green\" alt=\"Repo Size\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/python-3.8+-blue?logo=python\u0026logoColor=white\" alt=\"Python\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-USB%20%7C%20Local-blueviolet\" alt=\"Platform\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/works%20offline-yes-success\" alt=\"Offline\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://llm-wiki-lyart.vercel.app/\"\u003e🌐 llm-wiki-lyart.vercel.app\u003c/a\u003e\n\u003c/p\u003e\n\nYour personal AI-powered knowledge base — on a USB stick or any folder.\n\nBased on the [Karpathy LLM Wiki method](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). Works with **Claude Code** and **OpenCode**. Write markdown pages with `[[wikilinks]]`, visualize them as a 3D graph, and carry everything on a USB drive. Ask Claude to ingest sources, query your knowledge base, and generate new pages automatically.\n\n## Features\n\n- **3D Knowledge Graph** — Interactive force-directed graph, color-coded by category\n- **AI-Powered** — Claude Code or OpenCode read, write, and query the wiki for you\n- **USB Portable** — Plug into any PC, run one command, done\n- **Markdown + Wikilinks** — `[[page-links]]` like Obsidian, backlinks auto-generated\n- **Offline** — Static HTML/JS, works with `file://`, no server needed\n- **Python 3.8+** — No external dependencies beyond Python for the core\n\n## Dashboard\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/dashboard.webp\" alt=\"Dashboard — 3D Knowledge Graph with sidebar navigation\" width=\"700\"\u003e\n\u003c/p\u003e\n\nInteractive 3D graph with color-coded categories: **Fonti** (blue), **Entità** (green), **Concetti** (amber), **Confronti** (purple). Click any node to read the page. Sidebar with live search (searches titles, tags, and content). Keyboard: `/` to search, `Esc` to go back.\n\n## Quick Start\n\n### Step 1 — Clone the repo\n\n```bash\ngit clone https://github.com/inferis995/llm-wiki-portable\ncd llm-wiki-portable\n```\n\n### Step 2 — Install commands\n\n```bash\n# Linux / macOS\nbash install-commands.sh\n\n# Windows (PowerShell)\npowershell -File install-commands.ps1\n```\n\nThis copies the slash commands to Claude Code and OpenCode.\n\n### Step 3 — Set up your wiki\n\nOpen **Claude Code** or **OpenCode** and run:\n\n```\n/install-portable-wiki\n```\n\nClaude will ask:\n1. **Where** to put the wiki (USB drive path or any folder)\n2. **Which template** to use:\n\n| Template | Use case | Folders |\n|----------|----------|---------|\n| `general` | General use, study, notes, personal research — original Karpathy method | sources / entities / concepts / comparisons |\n| `work` | Freelance / project \u0026 client management | projects / clients / meetings / tasks / resources |\n| `business` | Company knowledge base, SOPs, decisions | departments / processes / people / decisions / documents / meetings |\n| `professional` | Lawyer, accountant, consultant, doctor | clients / matters / deadlines / contacts |\n| `research` | Researcher, journalist, PhD student, analyst | sources / insights / topics / people / output |\n| `custom` | Any domain — Claude generates the structure from your answers | folders defined during setup |\n\nThen Claude will:\n- Copy the web UI and sync script\n- Write `~/.claude/CLAUDE.md` globally so Claude finds your wiki from any directory\n- Create the folder structure for your chosen template\n\n\u003cdetails\u003e\n\u003csummary\u003eOpenCode with commands\u003c/summary\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/opencode-commands.webp\" alt=\"OpenCode with LLM Wiki Portable commands\" width=\"600\"\u003e\n\u003c/p\u003e\n\n\u003c/details\u003e\n\n### Step 4 — Use it\n\n```\n/llm-dashboard    ← Open the 3D graph in your browser\n```\n\nThen talk to Claude:\n- *\"Ingest this PDF\"* → Claude creates wiki pages with wikilinks\n- *\"What do I know about Docker networking?\"* → Claude reads the wiki and answers\n- *\"Show me everything related to [[kubernetes]]\"* → Claude reads the graph\n\n\u003e **After setup:** Claude finds your wiki from **any directory** — you don't need to open a terminal in the wiki folder. The global `~/.claude/CLAUDE.md` points to your USB/folder path.\n\n## Templates\n\n| Template | Use case | Folders |\n|----------|----------|---------|\n| `general` | General use, study, notes, personal research — original Karpathy method | `sources / entities / concepts / comparisons` |\n| `work` | Freelance / project \u0026 client management | `projects / clients / meetings / tasks / resources` |\n| `business` | Company knowledge base, SOPs, decisions | `departments / processes / people / decisions / documents / meetings` |\n| `professional` | Lawyer, accountant, consultant, doctor | `clients / matters / deadlines / contacts` |\n| `research` | Researcher, journalist, PhD student, analyst | `sources / insights / topics / people / output` |\n| `custom` | Any domain — Claude generates the structure from your answers | folders defined during setup |\n\nAll templates use the same Karpathy method: ingest → query → lint. Claude rewrites existing pages with progressive synthesis — pages always represent the state of the art, not accumulated notes. The 3D graph colors are assigned automatically from the actual folders in your wiki.\n\n## How It Works\n\nBased on the Karpathy method — the LLM acts as a \"compiler\" that incrementally builds a structured wiki from raw sources. Claude reads markdown files directly; no embedding server or vector database needed.\n\n```\n~/.claude/CLAUDE.md          ← Global AI instructions (points to your USB path)\n~/.config/opencode/agents/wiki.md  ← OpenCode global agent\n\nUSB Drive (or any folder)/\n├── wiki/                    ← Your pages (markdown with wikilinks)\n│   ├── sources/src-*.md     ← Source summaries\n│   ├── entities/            ← Tools, companies, people\n│   ├── concepts/            ← Ideas, protocols, patterns\n│   └── comparisons/         ← A vs B\n├── raw/                     ← Original files (PDFs, images) — never modified\n├── web/                     ← Static web UI (open index.html in browser)\n│   └── data.js              ← Auto-generated by sync.py\n└── sync.py                  ← Regenerates graph data from markdown\n```\n\n### The Workflow\n\n1. **You give Claude a source** (PDF, URL, paste text)\n2. **Claude creates wiki pages** with `[[wikilinks]]` and cross-references\n3. **Claude runs `sync.py`** to rebuild the graph\n4. **You open `/llm-dashboard`** to see the 3D graph\n5. **You ask questions** — Claude reads the wiki files and answers with `[[citations]]`\n\n### Moving to Another PC\n\nPlug the USB into a new computer → open Claude Code or OpenCode → run `/install-portable-wiki`. The command detects the existing wiki and only configures the local system (global CLAUDE.md, commands). Your data stays on the USB.\n\n## Page Format\n\n```markdown\n---\ncreated: 2026-05-08\nupdated: 2026-05-08\nsources: [[src-my-source]]\ntags: [tag1, tag2]\n---\n\n# Page Title\n\nContent with [[wikilinks]] to other pages.\n\n## Key Points\n- Point 1\n\n## Related\n- [[other-page]]\n```\n\n## Requirements\n\n| Requirement | Notes |\n|-------------|-------|\n| **Claude Code** or **OpenCode** | AI assistant that runs the commands |\n| **Python 3.8+** | For `sync.py` (generates the 3D graph data) |\n| **USB drive or folder** | Any writable path works |\n| **Browser** | For the 3D graph UI |\n\n\u003e Python must be in your system PATH before running `install-commands.sh`.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/install-portable-wiki` | Install wiki on USB or configure on a new PC |\n| `/llm-dashboard` | Open the 3D graph in browser (auto-syncs if pages changed) |\n\n## Tech Stack\n\n- **Web UI**: Vanilla HTML/CSS/JS (no framework, no build step)\n- **Graph**: [3d-force-graph](https://github.com/vasturiano/3d-force-graph) + Three.js + D3.js\n- **Markdown**: [marked.js](https://marked.js.org/)\n- **Sync**: `sync.py` — zero dependencies, Python 3.8+\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finferis995%2Fllm-wiki-portable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finferis995%2Fllm-wiki-portable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finferis995%2Fllm-wiki-portable/lists"}