Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

knowledge-graph-basement

A Markdown corpus Agent + multi-visualization playground. Take any folder of .md notes → see it as 16 different graphs.

What is this?

A tool that indexes a Markdown corpus (LLM-wiki / Obsidian vault / digital garden / plain notes folder), extracts the knowledge graph (entities + sections + links), and renders the corpus through 16 different visualizations — from classic force-directed graphs to 3D knowledge galaxies to graph-of-thoughts.

Status

Phase 0 — scaffolding + corpus exploration. See docs/progress.md for current state.

Quick start

./scripts/bootstrap.sh     # one-time setup (clone test corpus, install deps)
npm run index              # parse corpus → data/index.json
npm run stats              # print graph statistics
npm run dev                # start viz playground

Architecture (planned)

Layer Tech Purpose
Parser unified + remark + mdast-util-from-markdown Parse .md to AST
Indexer Node.js (this repo) Extract nodes, edges, sections, frontmatter
Storage SQLite (FTS5) + JSON snapshots Fast search + portable cache
Embeddings sqlite-vec or LanceDB (later) Semantic search
Agent Claude API + local Ollama (later) NL queries, summarization
Viz Astro + D3.js + visx + Cytoscape + ECharts + regl 16+ viz types
Deploy Cloudflare Pages (later) Static + edge

16 visualizations (planned)

See docs/viz-ideas.md for the full list and priority order.

Test corpus

This project uses caro401/notes as its initial test corpus (cloned into corpus/, gitignored). It's a real, populated Obsidian vault with ~228 single-concept notes, cross-linked, MIT-licensed. Swap in your own corpus by replacing corpus/.

License

Code: MIT. Test corpus (in corpus/) is MIT (caro401's license).

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages