# Similar Notes for Obsidian

Find semantically similar notes using AI, directly on your device. Works on both desktop and mobile without external servers.

![Demo](images/demo.gif)

## Features

-   **Mobile & Desktop**: Works on iOS, Android, and all desktop platforms
-   **100% Private**: All processing happens locally on your device
-   **Built-in Models**: Uses Hugging Face models, no setup required
-   **Ollama Support**: Connect to custom models via Ollama (desktop only)
-   **No API Keys**: No ChatGPT, Claude, or cloud services needed

## How It Works

The plugin understands the meaning behind your content, not just keywords. As you write, it shows the 5 most similar notes at the bottom of your current note, excluding already-linked notes.

## Getting Started

1. Install the plugin
2. The default model will download automatically (one-time, ~30MB)
3. Your notes will be indexed in the background
4. Similar notes will appear at the bottom of your current note

Progress appears in the status bar.

## Model Options

### Built-in Models (Mobile & Desktop)
-   **Default**: `all-MiniLM-L6-v2` (English)
-   **Multilingual**: `paraphrase-multilingual-MiniLM-L12-v2`
-   **Custom**: Any Sentence Transformer model from Hugging Face

### Ollama (Desktop Only)
Connect to any Ollama embedding model on `localhost:11434`

> Changing models triggers re-indexing.

## Technical Details

-   **Transformers.js**: Runs Hugging Face models directly in Obsidian
-   **WebGPU**: GPU acceleration on desktop, automatic CPU fallback
-   **Orama**: Built-in vector database for fast search
-   **Web Workers**: All processing runs in background threads

## Sync Exclusions

If you use file syncing tools like Syncthing, you should exclude the plugin's database files to avoid conflicts:

**Files to exclude:**
- `.obsidian/plugins/similar-notes/similar-notes.json`
- `.obsidian/plugins/similar-notes/similar-notes-file-mtimes.json`

> **Note**: Obsidian Sync appears to work fine with these files. However, if you experience any sync-related issues, consider excluding the entire plugin directory.

## License

[MIT](LICENSE)