MEMORY LLM PORTABLE v1.0 · BOOT OK

Your knowledge.
Your USB.
Your AI.

Based on the Karpathy LLM Wiki method. Markdown pages, wikilinks, 3D knowledge graph — always with you, like a save file on a memory card. Works with Claude Code, OpenCode and Hermes Agent.

Claude Code OpenCode Hermes Agent USB Portable Works Offline Python 3.8+ MIT License
SAVE DATA OK
LLM WIKI PORTABLE
USB Knowledge Base
6 / 16 BLOCKS KARPATHY METHOD

Everything your knowledge base needs.

🌐

3D KNOWLEDGE GRAPH

Interactive force-directed graph, color-coded by folder. Click any node to read the page. Backlinks auto-generated. Runs entirely in your browser.

🤖

AI-POWERED

Claude Code, OpenCode or Hermes Agent read, write, and query the wiki for you. Give your AI a PDF — it builds distilled pages with [[wikilinks]] automatically.

💾

USB PORTABLE

Your entire knowledge base on a USB stick. Plug into any PC, run one command — done. Like a save file, always with you.

🔗

WIKILINKS

[[page-links]] like Obsidian. Cross-references, backlinks, and graph connections — all resolved automatically by sync.py.

📡

WORKS OFFLINE

Static HTML/JS, works with file://. No server, no cloud, no internet required after setup. Your data never leaves your drive.

ZERO DEPS

Python 3.8+ for sync.py, that's it. No npm, no Docker, no setup hell. Copy the folder, it just works.

HERMES AGENT

Full support for Hermes Agent by Nous Research. Self-improving AI that learns your workflows, creates skills from experience, and deepens its knowledge of your domain across sessions.

Three steps. Infinite knowledge.

01

GIVE CLAUDE A SOURCE

PDF, URL, pasted text, meeting notes — anything. Claude reads it in full and understands what matters.

02

CLAUDE BUILDS THE WIKI

Distilled pages with [[wikilinks]]. No appending — Claude rewrites pages. They get sharper over time, not longer.

03

EXPLORE THE GRAPH

Open /llm-dashboard. Navigate the 3D graph, search nodes, query Claude — it answers directly from the wiki.

Choose your template.

SLOT 01
GENERAL
Study, notes, personal research — the original Karpathy method. The default starting point.
sourcesentitiesconceptscomparisons
SLOT 02
WORK
Freelance, projects, client management. Meetings are historical records — never overwritten.
projectsclientsmeetingstasksresources
SLOT 03
BUSINESS
Company knowledge base, SOPs, architectural decisions. Status: active · draft · deprecated.
departmentsprocessespeopledecisionsdocuments
SLOT 04
PROFESSIONAL
Lawyer, accountant, consultant, doctor. Client matters, deadlines, contacts — structured.
clientsmattersdeadlinescontacts
SLOT 05
RESEARCH
Researcher, journalist, PhD, analyst. Topics have an explicit thesis. Output for publishing.
sourcesinsightstopicspeopleoutput
NEW
SLOT 06
CUSTOM
Claude asks you 3 questions about your domain, then generates folder structure, CLAUDE.md and AGENTS.md from scratch.
your domainyour termsyour structure

Up and running in 3 steps.

terminal
# 1 — Clone the repo
$ git clone https://github.com/inferis995/llm-wiki-portable
$ cd llm-wiki-portable

# 2 — Install commands (Linux / macOS)
$ bash install-commands.sh
✓ Commands installed for Claude Code + OpenCode + Hermes

# 3 — Open Claude Code, OpenCode or Hermes and run
/install-portable-wiki

# Then open the 3D graph
/llm-dashboard
1

CLONE THE REPO

The repo is just the installer. Your wiki lives on the USB — not in the repo.

2

INSTALL COMMANDS

One script installs slash commands for Claude Code, OpenCode and Hermes Agent. Windows, macOS, Linux covered.

3

RUN /INSTALL-PORTABLE-WIKI

Choose: local or USB? New or migrate? Which template? Claude sets up folders, CLAUDE.md, and the graph.

START INGESTING

Tell Claude: "Read this PDF and add it to the wiki." Claude finds your wiki from any directory, automatically.

Explore the 3D knowledge graph.

DRAG TO ROTATE · SCROLL/PINCH TO ZOOM · HOVER NODES
0 PAGES
0 LINKS
0 CLUSTERS

Common questions.

Yes. The web UI is static HTML/JS and works with file://. Claude reads your markdown files directly — no server, no vector database, no external API calls for the wiki itself.

Yes. The install command configures Claude Code (~/.claude/CLAUDE.md), OpenCode (~/.config/opencode/agents/wiki.md) and Hermes Agent (~/.hermes/skills/) automatically.

Plug in the USB, open your AI agent (Claude Code, OpenCode or Hermes), run /install-portable-wiki and choose "Nuovo PC". The agent detects the existing wiki and only configures the local system. Your data stays on the USB, untouched.

Yes. Choose "Da locale a USB" during install. Claude copies your wiki/ and raw/ folders to the USB, then regenerates CLAUDE.md with the new path automatically.

Your wiki files are local markdown on your machine or USB. The only external calls are Claude's normal AI API calls when you interact with it — nothing else is sent anywhere.

Yes. Run /install-portable-wiki again pointing to a different path. Each wiki gets its own config — switch between them by updating the global config.

Hermes Agent by Nous Research is fully supported. The install command creates a Hermes skill in ~/.hermes/skills/ that gives Hermes full access to your wiki — read, write, query, and sync. Hermes can also auto-improve your wiki pages using its self-improving learning loop.

Start building your knowledge base.

Three commands. Your AI. Your USB.
Your knowledge — always with you.