A local Streamlit dashboard that scans an Obsidian vault and generates an overview of its structure — including topic clusters, large notes, heavily linked notes, and small cleanup candidates.
Obsidian vaults grow fast and become hard to navigate. This tool scans a vault directory, parses the markdown files and their internal links, and produces a visual summary so you can understand what is actually in your vault — what topics dominate, which notes are over-linked or under-developed, and where cleanup is needed.
- Scans any local Obsidian vault folder
- Visualises topic distribution across notes
- Identifies large notes, heavily linked notes, and orphaned or minimal notes
- Runs entirely locally — no data leaves your machine
- Simple one-click analysis via a Streamlit sidebar
obisidian-vault-summarizer/
├── app.py # Streamlit app entry point
├── main.py # Core orchestration logic
├── scanner.py # Vault directory scanner and markdown parser
├── analyzer.py # Analysis and chart generation
├── tests/ # Pytest test suite
├── requirements.txt
└── pytest.ini
- Python 3.9+
python -m venv .venv
# macOS / Linux
source .venv/bin/activate
# Windows (PowerShell)
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txtstreamlit run app.py- Open the app in your browser (Streamlit will print the local URL on startup).
- In the sidebar, select your Obsidian vault folder.
- Click Analyze Vault.
- Browse the generated charts and summary tables.
pytestMIT — see LICENSE for details.