obsidian-notes-rag 0.1.2__tar.gz

obsidian_notes_rag-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Type check
+        run: uv run pyright
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest -v

obsidian_notes_rag-0.1.2/.github/workflows/release-please.yml

@@ -0,0 +1,20 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: googleapis/release-please-action@v4
+        with:
+          release-type: python
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json

obsidian_notes_rag-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,50 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Git tag to publish (e.g., v0.1.0)'
+        required: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag || github.ref }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

obsidian_notes_rag-0.1.2/.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Project specific
+data/
+.claude/
+
+# OS
+.DS_Store
+Thumbs.db

obsidian_notes_rag-0.1.2/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.2"
+}

obsidian_notes_rag-0.1.2/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+## [0.1.2](https://github.com/ernestkoe/obsidian-rag/compare/v0.1.1...v0.1.2) (2026-01-04)
+
+
+### Bug Fixes
+
+* disable attestations for token-based auth ([8d70f98](https://github.com/ernestkoe/obsidian-rag/commit/8d70f989f3e50c7d9f6a5f045d0cc767646c0686))
+* use API token for PyPI publish ([51a2c09](https://github.com/ernestkoe/obsidian-rag/commit/51a2c0958e226b128a2a34c9ec0a8e2c75102a93))
+
+## [0.1.1](https://github.com/ernestkoe/obsidian-rag/compare/v0.1.0...v0.1.1) (2026-01-04)
+
+
+### Bug Fixes
+
+* add manual trigger to release workflow ([130dfd0](https://github.com/ernestkoe/obsidian-rag/commit/130dfd0cfddce817863998042ee783791b8204a9))
+
+## 0.1.0 (2026-01-03)
+
+
+### ⚠ BREAKING CHANGES
+
+* Project renamed from obsidian-memory to mcp-obsidianRAG
+
+### Features
+
+* add file watcher daemon with launchd integration ([23d2429](https://github.com/ernestkoe/obsidian-rag/commit/23d2429c61d82e98610c0180f7044b807ad9cd60))
+* add OpenAI embeddings and setup wizard ([e1e363e](https://github.com/ernestkoe/obsidian-rag/commit/e1e363ee26a70d82635d7c8bf2bec38afaf28383))
+* consolidate CLI entry points for uvx workflow ([95eb546](https://github.com/ernestkoe/obsidian-rag/commit/95eb546b0a7d6d89d30da8d0dd4f7c4c64600657))
+
+
+### Documentation
+
+* add TODOs for Linux/Windows service support ([569a830](https://github.com/ernestkoe/obsidian-rag/commit/569a830b5272c7fdd0c8ba826063b765706ecdcf))
+
+
+### Code Refactoring
+
+* rename project to mcp-obsidianRAG ([16a83d9](https://github.com/ernestkoe/obsidian-rag/commit/16a83d9ebe142f25231a33824b7c27237f61da73))

obsidian_notes_rag-0.1.2/CLAUDE.md

@@ -0,0 +1,85 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+obsidian-rag is an MCP (Model Context Protocol) server that provides semantic search over Obsidian notes. It uses OpenAI embeddings by default (or Ollama for local processing) with ChromaDB for vector storage.
+
+## Commands
+
+```bash
+# Install dependencies
+uv sync --dev
+
+# Run tests
+.venv/bin/python -m pytest -v
+
+# Type checking
+.venv/bin/python -m pyright
+
+# Interactive setup wizard
+uv run obsidian-rag setup
+
+# Index vault (manual refresh)
+uv run obsidian-rag index
+
+# Run the MCP server (stdio transport)
+uv run obsidian-rag serve
+
+# Watch vault for changes
+uv run obsidian-rag watch
+
+# Search from CLI
+uv run obsidian-rag search "query"
+```
+
+## Architecture
+
+### Data Flow
+
+```
+Obsidian Vault → VaultIndexer → Embedder (OpenAI/Ollama) → VectorStore (ChromaDB)
+                                                                  ↓
+MCP Client ← FastMCP Server ← search_notes/get_similar/etc.
+```
+
+### Key Components (src/obsidian_rag/)
+
+- **config.py**: `Config` dataclass, `load_config()`/`save_config()` for TOML config file, cross-platform paths via `platformdirs`
+- **indexer.py**: `VaultIndexer` scans markdown files, `chunk_by_heading()` splits content by `##`/`###` headings, `OpenAIEmbedder` and `OllamaEmbedder` generate embeddings, `create_embedder()` factory selects provider
+- **store.py**: `VectorStore` wraps ChromaDB with cosine similarity search, handles upsert/delete by file path
+- **server.py**: FastMCP server exposing 5 tools: `search_notes`, `get_similar`, `get_note_context`, `get_stats`, `reindex`
+- **watcher.py**: `VaultWatcher` uses watchdog with debouncing (default 2s) to incrementally re-index on file changes
+- **cli.py**: Click-based CLI with `setup` wizard, `--provider` option, commands for indexing, searching, watching, and service management
+
+### Chunking Strategy
+
+Files are split by `##` and `###` headings. Chunks smaller than `min_chunk_size` (default 100 chars) merge with the previous chunk. Files without headings become a single chunk.
+
+### Metadata
+
+Each chunk stores: `file_path`, `heading`, `heading_level`, `type` ("daily" if path starts with "Daily Notes/", else "note"), and tags from YAML frontmatter.
+
+## Configuration
+
+Config file location (created by `setup` command):
+- macOS/Linux: `~/.config/obsidian-rag/config.toml`
+- Windows: `%APPDATA%/obsidian-rag/config.toml`
+
+Environment variables (override config file):
+- `OPENAI_API_KEY` - OpenAI API key (required for default provider)
+- `OBSIDIAN_RAG_PROVIDER` - `openai` (default) or `ollama`
+- `OBSIDIAN_RAG_VAULT` - Path to Obsidian vault
+- `OBSIDIAN_RAG_DATA` - ChromaDB storage path
+- `OBSIDIAN_RAG_OLLAMA_URL` - Ollama API (default: `http://localhost:11434`)
+- `OBSIDIAN_RAG_MODEL` - Override embedding model
+
+## Testing
+
+Tests are in `tests/`. Current coverage focuses on `test_indexer.py` for frontmatter parsing and chunking logic.
+
+```bash
+# Run a specific test
+uv run pytest tests/test_indexer.py::TestChunkByHeading::test_multiple_headings -v
+```

obsidian_notes_rag-0.1.2/CONTRIBUTING.md

@@ -0,0 +1,116 @@
+# Contributing to obsidian-rag
+
+## Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/ernestkoe/obsidian-rag.git
+cd obsidian-rag
+
+# Install with dev dependencies
+uv sync --dev
+
+# Pull the embedding model
+ollama pull nomic-embed-text
+```
+
+## Project Structure
+
+```
+src/obsidian_rag/
+├── __init__.py      # Package version
+├── cli.py           # Click CLI commands
+├── server.py        # MCP server (FastMCP)
+├── indexer.py       # Markdown parsing, chunking, Ollama embeddings
+├── store.py         # ChromaDB vector store wrapper
+└── watcher.py       # File watcher daemon (watchdog)
+```
+
+## Architecture
+
+### Indexing Pipeline
+
+1. **VaultIndexer** scans markdown files, excludes patterns (`.obsidian/`, etc.)
+2. **parse_frontmatter()** extracts YAML frontmatter
+3. **chunk_by_heading()** splits content by `##` and `###` headings
+4. **OllamaEmbedder** generates embeddings via local Ollama API
+5. **VectorStore** persists chunks + embeddings to ChromaDB
+
+### MCP Server
+
+The server exposes 5 tools via FastMCP:
+- `search_notes` - Semantic search
+- `get_similar` - Find similar notes
+- `get_note_context` - Note + related context
+- `get_stats` - Index statistics
+- `reindex` - Re-index vault
+
+### File Watcher
+
+Uses watchdog to monitor the vault directory:
+- Debounces rapid file changes (default 2s)
+- Handles create/modify/delete/move events
+- Can run as macOS launchd service
+
+## Running Tests
+
+```bash
+uv run pytest -v
+```
+
+## Type Checking
+
+```bash
+uv run pyright
+```
+
+## Code Style
+
+- Python 3.11+
+- Type hints required
+- Docstrings for public functions
+
+## Making Changes
+
+1. Create a feature branch
+2. Make changes with tests
+3. Ensure `pytest` and `pyright` pass
+4. Submit PR with conventional commit message
+
+### Commit Messages
+
+Use [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+feat: add new search filter
+fix: handle empty vault gracefully
+docs: update installation instructions
+refactor: simplify chunking logic
+```
+
+## Release Process
+
+Releases are automated via [release-please](https://github.com/googleapis/release-please). When PRs with conventional commits are merged to `main`, release-please creates a release PR that bumps the version and updates the changelog.
+
+## Environment Variables
+
+For development, you can set these in your shell or a `.env` file:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OBSIDIAN_RAG_VAULT` | (hardcoded) | Path to Obsidian vault |
+| `OBSIDIAN_RAG_DATA` | (hardcoded) | Path to ChromaDB data |
+| `OBSIDIAN_RAG_OLLAMA_URL` | `http://localhost:11434` | Ollama API URL |
+| `OBSIDIAN_RAG_MODEL` | `nomic-embed-text` | Embedding model |
+| `OBSIDIAN_RAG_DEBOUNCE` | `2.0` | Watcher debounce seconds |
+
+## Key Dependencies
+
+| Package | Purpose |
+|---------|---------|
+| chromadb | Vector store |
+| watchdog | File system monitoring |
+| mcp | MCP server framework |
+| httpx | HTTP client for Ollama |
+| click | CLI framework |
+| pyyaml | Frontmatter parsing |

obsidian_notes_rag-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ernest Koe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

obsidian_notes_rag-0.1.2/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: obsidian-notes-rag
+Version: 0.1.2
+Summary: MCP server for semantic search over Obsidian notes using local RAG
+Project-URL: Homepage, https://github.com/ernestkoe/obsidian-rag
+Project-URL: Repository, https://github.com/ernestkoe/obsidian-rag
+Project-URL: Issues, https://github.com/ernestkoe/obsidian-rag/issues
+Author: Ernest Koe
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: chromadb>=0.4.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: platformdirs>=3.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: watchdog>=3.0.0
+Description-Content-Type: text/markdown
+
+# obsidian-rag
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for semantic search over your Obsidian vault. Uses OpenAI embeddings by default (or Ollama for local processing) with ChromaDB for vector storage.
+
+## What it does
+
+Ask natural language questions about your notes:
+- "What did I write about project planning?"
+- "Find notes similar to my meeting notes from last week"
+- "What's in my daily notes about the API refactor?"
+
+## Requirements
+
+- Python 3.11+
+- `OPENAI_API_KEY` environment variable (or [Ollama](https://ollama.ai/) for local embeddings)
+
+## Quick Start
+
+The easiest way to get started is with [uvx](https://docs.astral.sh/uv/guides/tools/) (no installation required):
+
+```bash
+# Run the setup wizard
+uvx obsidian-rag setup
+
+# Add to Claude Code
+claude mcp add obsidian-rag -- uvx obsidian-rag serve
+```
+
+### Alternative: Clone and install
+
+```bash
+git clone https://github.com/ernestkoe/obsidian-rag.git
+cd obsidian-rag
+uv sync
+
+uv run obsidian-rag setup
+claude mcp add obsidian-rag -- uv run --directory /path/to/obsidian-rag obsidian-rag serve
+```
+
+The setup wizard will:
+1. Ask for your embedding provider (OpenAI or Ollama)
+2. Configure your API key (for OpenAI)
+3. Set your Obsidian vault path
+4. Choose where to store the search index
+5. Optionally run the initial indexing
+
+### Manual Setup (alternative)
+
+```bash
+# Set your API key and index directly
+export OPENAI_API_KEY=sk-...
+uv run obsidian-rag index --vault /path/to/your/vault
+```
+
+### Using Ollama (local, offline)
+
+```bash
+# Install Ollama and pull the embedding model
+ollama pull nomic-embed-text
+
+# Run setup with Ollama, or index directly:
+uv run obsidian-rag --provider ollama index --vault /path/to/your/vault
+```
+
+## MCP Tools
+
+Once connected, these tools are available to Claude:
+
+| Tool | What it does |
+|------|--------------|
+| `search_notes` | Find notes matching a query |
+| `get_similar` | Find notes similar to a given note |
+| `get_note_context` | Get a note with related context |
+| `get_stats` | Show index statistics |
+| `reindex` | Update the index |
+
+## Keeping the Index Fresh
+
+### Option 1: Manual reindex
+
+```bash
+uv run obsidian-rag index
+```
+
+### Option 2: Watch for changes
+
+```bash
+uv run obsidian-rag watch
+```
+
+### Option 3: Auto-start on login (macOS)
+
+```bash
+uv run obsidian-rag install-service
+```
+
+## CLI Reference
+
+```bash
+obsidian-rag setup                # Interactive setup wizard
+obsidian-rag serve                # Start MCP server (for Claude Code)
+obsidian-rag index [--clear]      # Index vault (--clear to rebuild)
+obsidian-rag search "query"       # Search from command line
+obsidian-rag watch                # Watch for file changes
+obsidian-rag stats                # Show index stats
+obsidian-rag install-service      # Install macOS launchd service
+obsidian-rag uninstall-service    # Remove service
+obsidian-rag service-status       # Check service status
+```
+
+## Configuration
+
+Set your vault path and provider via CLI options or environment variables:
+
+```bash
+# CLI options
+uv run obsidian-rag --vault /path/to/vault index
+uv run obsidian-rag --provider ollama index
+
+# Environment variables
+export OBSIDIAN_RAG_VAULT=/path/to/vault
+export OBSIDIAN_RAG_PROVIDER=ollama  # or "openai" (default)
+```
+
+| Variable | Description |
+|----------|-------------|
+| `OPENAI_API_KEY` | OpenAI API key (required for default provider) |
+| `OBSIDIAN_RAG_PROVIDER` | Embedding provider: `openai` (default) or `ollama` |
+| `OBSIDIAN_RAG_VAULT` | Path to Obsidian vault |
+| `OBSIDIAN_RAG_DATA` | Where to store the index (default: `./data`) |
+| `OBSIDIAN_RAG_OLLAMA_URL` | Ollama API URL (default: `http://localhost:11434`) |
+| `OBSIDIAN_RAG_MODEL` | Override embedding model |
+
+## How it works
+
+1. Parses your markdown files and splits them by headings
+2. Generates embeddings using OpenAI API (or Ollama for local processing)
+3. Stores vectors in ChromaDB (local, persistent)
+4. MCP server provides semantic search to Claude
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.
+
+## License
+
+MIT