Grafezy

Turn any Markdown vault into a living, explorable knowledge graph in seconds.

Grafezy is a portable, browser-based graph viewer built for people who want their notes to feel connected, visual, and immediately usable. No cloud setup. No heavy app install. Just a local folder, a launcher, and a graph that comes alive.

Why people keep using it

• Instantly maps note relationships into a clear visual network
• Works with plain HTML, PowerShell, and Python
• Keeps your vault as the source of truth
• Updates live as your Markdown changes
• Runs locally on 127.0.0.1 for privacy and simplicity

Quick start on Windows

1. Install Python 3 if it is not already available.
2. Double-click start-graph.cmd.
3. Open the printed local URL, usually http://127.0.0.1:8765/index.html?live=1.

The bundled sample-vault is used by default, so the tool works immediately after extraction.

If you want to see the experience at its best, open the sample vault first and explore the clusters, hover states, and search flow before pointing Grafezy at your own notes.

Use your own vault

Run the launcher with the vault folder as an argument:

.\start-graph.cmd -VaultPath "C:\Users\you\Documents\My Vault"

Or use PowerShell directly:

powershell -ExecutionPolicy Bypass -File .\scripts\start-graph.ps1 `
  -VaultPath "C:\Users\you\Documents\My Vault" `
  -Port 8765

The scanner reads .md and .txt files, extracts wikilinks, reads common YAML metadata, and writes a derived graph-data.js file. It excludes .obsidian, .git, node_modules, templates, scripts, and Welcome.md.

That means you can point it at a messy real-world vault and still get a clean, readable graph without extra cleanup.

Stop the live watcher

.\stop-graph.cmd

The viewer polls the generated data in the background and updates nodes and links in place without reloading the visible page. The local server binds to 127.0.0.1 only, so it is not exposed to other devices on your network.

Included features

• Topic-aware colors that make clusters easy to scan
• Global and connected-chain focus on hover and click
• Node dragging with mild spring movement for connected notes
• Pan and zoom for large vaults
• Sequential node-growth animation for a polished reveal
• Search, filters, arrows, text fade, node sizing, and link sizing
• A standalone settings drawer for fast exploration
• Live vault updates while you keep editing
• Local browser-only rendering with no server exposure

Best For

• People who think better with maps than lists
• Research vaults with lots of cross-links
• Personal knowledge bases that need visual momentum
• Demos and portfolio screenshots that need instant visual impact

Portable design

The Markdown vault remains the source of truth. The graph data is disposable and can be regenerated at any time. Copy this folder anywhere, point it at another vault, and run the launcher.

Grafezy is designed to feel like a note vault with gravity: everything stays local, but the connections become easy to see.

Troubleshooting

• If the browser does not open, copy the URL printed by start-graph.cmd into a browser.
• If port 8765 is busy, use -Port 8766.
• If live updates do not appear, confirm the watcher is running and refresh the page once after changing the UI files.