← all repositories
brianpetro/obsidian-smart-connections

Obsidian's forgetful-note antidote runs offline

A local embedding model that resurfaces semantically related notes while you write, no API key required.

5.3k stars JavaScript RAG · SearchChat Assistants
obsidian-smart-connections
Not currently ranked — collecting fresh signals.
star history

What it does Smart Connections is an Obsidian plugin that indexes your entire note vault using a local embedding model, then surfaces related notes and excerpts in a sidebar as you write. It offers two main views: Connections (contextual suggestions based on your current note) and Lookup (ad hoc semantic search across the vault). Results are scored by semantic similarity, not keyword matching, so a note about “distributed systems” might surface when you’re writing about “microservices” even if the exact words never overlap.

The interesting bit The plugin ships with its own embedding model and runs entirely offline — no API keys, no cloud calls, no configuration files to wrestle with. The author claims the streamlined, minimal-dependency codebase can be audited “>3× faster than comparable AI plugins,” which is either a flex about code hygiene or a subtle dig at the typical Obsidian AI plugin bloat. Either way, the privacy-default posture is genuinely unusual in this space.

Key highlights

  • Zero-setup local embeddings: install, enable, and indexing starts automatically
  • Fully offline and private; works on mobile devices
  • Drag-to-link workflow: pull related notes directly into your current document
  • Random connection feature for serendipitous rediscovery
  • Pro plugins (paid) add inline suggestions, Bases integration, and deeper configuration
  • Source-available core with local-first data storage

Caveats

  • Semantic search behaves unintuitively if you expect keyword matching — exact text may not appear in results
  • Advanced features and power-user workflows moved to Pro plugins in v4; the free version is deliberately simplified
  • The “3× faster audit” claim lacks methodology or benchmarks in the README

Verdict Worth a look for Obsidian users with hundreds of notes who keep rediscovering forgotten writing. Skip it if your vault is small enough that Ctrl+O already solves your problems, or if you need precise boolean search rather than fuzzy semantic similarity.

Frequently asked

What is brianpetro/obsidian-smart-connections?
A local embedding model that resurfaces semantically related notes while you write, no API key required.
Is obsidian-smart-connections open source?
Yes — brianpetro/obsidian-smart-connections is an open-source project tracked on heatdrop.
What language is obsidian-smart-connections written in?
brianpetro/obsidian-smart-connections is primarily written in JavaScript.
How popular is obsidian-smart-connections?
brianpetro/obsidian-smart-connections has 5.3k stars on GitHub.
Where can I find obsidian-smart-connections?
brianpetro/obsidian-smart-connections is on GitHub at https://github.com/brianpetro/obsidian-smart-connections.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.