local-first ● vault files never modified ● MIT

Drop anything.
It compiles itself
into knowledge.

Self-compiling Zettelkasten MCP server. Ingest PDFs, YouTube, documents—auto-organized into linked wiki. Claude accesses your entire knowledge base through 21 MCP tools.

View on GitHub → View on GitHub →
171KB on npm ● 21 MCP tools ● 127 tests passing ● No cloud required
The Problem

Notes pile up.
Knowledge doesn't.

Three things break every knowledge system. Stellavault fixes all three automatically.

🗒
Problem
Notes rot in folders
You save articles, highlight books, clip videos. They never become connected knowledge.
↓
Auto-compiling wiki — raw notes become linked concepts in <100ms
🔎
Problem
Search finds words, not meaning
Keyword search misses semantic connections. You know you wrote it, but can't find it.
↓
Hybrid AI search — BM25 + vector + RRF, 50+ languages, locally
🤖
Problem
AI doesn't know what you know
ChatGPT has the internet. It doesn't have your notes, your decisions, your context.
↓
21 MCP tools — Claude searches, asks, drafts from your vault
The Pipeline

Karpathy's self-compiling loop,
built for your brain.

Inspired by Andrej Karpathy and Niklas Luhmann. Every input flows through the same pipeline. You never manually organize.

01
Capture
Drop PDF, paste YouTube, type thought. Drag files in browser. Any format.
02
Organize
Zettelkasten auto-classification. Index codes, tags, wikilinks auto-inserted.
03
Distill
Compile into wiki. Extract concepts. Detect gaps, contradictions, duplicates.
04
Express
Generate drafts. Blog, report, outline. AI-enhanced via Claude. Ship it.
The Compounding Loop

Gets smarter every session.

Every conversation with Claude becomes knowledge. Knowledge improves the next conversation. Karpathy's self-evolving architecture.

Session → session-save → daily-log → flush → wiki
↑↓
←← Claude reads wiki via MCP (21 tools) ←←←
session-save
Auto-capture decisions & lessons
flush
Daily logs → wiki compilation
Claude Code hooks
Fully automatic capture
See It In Action

Your vault as a
living neural network.

Semantic Search
Hybrid AI search — meaning, not just keywords
⛶
Knowledge Heatmap
Heatmap overlay — see where your knowledge lives
⛶
Light Mode
Light mode — monochrome with color on interaction
⛶
Claude Integration

Claude remembers
everything you know.

One command connects your vault to Claude Code. Claude searches, asks, and drafts from your knowledge. Local-first — no API key needed, no data leaves your machine.

$ claude mcp add stellavault -- stellavault serve
searchhybrid AI search
askQ&A from vault
generate-draftAI writes drafts
get-documentfull doc + meta
get-relatedsemantic neighbors
detect-gapsknowledge gaps
get-decay-statusfading memories
get-learning-pathreview order
get-evolutionidea drift tracking
link-codecode-knowledge links
create-knowledge-nodeAI writes notes
create-knowledge-linkauto-connect
log-decisiondecision journal
get-morning-briefdaily briefing
list-topicstopic cloud
exportJSON / CSV
find-decisionsdecision lookup
create-snapshotcontext save
load-snapshotcontext restore
generate-claude-mdauto CLAUDE.md
federated-searchP2P search
Ingest Anything

14 formats. One command.

Text extraction built-in. No external services. Transcripts with timestamps.

.pdf
unpdf
.docx
mammoth
.pptx
officeparser
.xlsx
SheetJS
.json
structured
.csv
table
.xml
clean text
.html
parsed
.yaml
config
.rtf
rich text
YouTube
yt-dlp transcript
URL
HTML to text
Get Started

5 minutes to a living
knowledge graph.

1
Install globally
npm install -g stellavault
171KB. Node.js 20+ required.
2
Initialize your vault
stellavault init
Interactive setup. Points to your Obsidian vault. Indexes everything.
3
Launch the graph
stellavault graph
3D neural graph in browser. Drag files to ingest. Mobile ready.
Under The Hood

Local-first. No cloud required.

Your knowledge stays on your machine. No API keys needed for core features.

Embeddingsmultilingual-MiniLM
Vector StoreSQLite-vec
SearchBM25 + Cosine + RRF
MemoryFSRS repetition
3D GraphReact Three Fiber
AI ProtocolMCP (21 tools)
RuntimeNode.js 20+ ESM
Package171KB on npm