本地RAG知识检索工具

xattr -cr /Applications/local-rag.app

# Prerequisites
brew install ollama go
ollama pull bge-m3

# Optional: OCR support for scanned PDFs
brew install tesseract tesseract-lang

# Build
git clone https://github.com/sebastianhutter/local-rag.git
cd local-rag
make build            # binary at bin/local-rag
make app              # macOS .app bundle at bin/local-rag.app
make dmg              # DMG installer at bin/local-rag.dmg

{
  "obsidian_vaults": ["~/Documents/MyVault"],
  "calibre_libraries": ["~/CalibreLibrary"],
  "repositories": {
    "my-org": ["~/Repository/my-org"]
  },
  "projects": {
    "client-docs": ["~/Documents/client-project/specs"]
  }
}

local-rag index obsidian
local-rag index email
local-rag index calibre
local-rag index rss
local-rag index code my-org --history
local-rag index all                        # everything at once

local-rag search "kubernetes deployment strategy"
local-rag search "invoice from supplier" --collection email
local-rag search "API specification" --type pdf --top 20
local-rag search "s3 bucket policy" --collection code --path infrastructure/modules

local-rag prune                 # all collections, including email/calibre/rss
local-rag prune obsidian        # a single collection

{
  "mcpServers": {
    "local-rag": {
      "type": "http",
      "url": "http://127.0.0.1:31123/mcp"
    }
  }
}

{
  "mcpServers": {
    "local-rag": {
      "command": "/path/to/local-rag",
      "args": ["serve"]
    }
  }
}

{
  "mcpServers": {
    "local-rag": {
      "command": "/path/to/local-rag",
      "args": ["serve"]
    }
  }
}

local-rag index obsidian [--vault/-V PATH]...   Index Obsidian vaults
local-rag index email                            Index eM Client emails
local-rag index calibre [--library/-l PATH]...   Index Calibre ebook libraries
local-rag index rss                              Index NetNewsWire RSS articles
local-rag index code [NAME] [--history]          Index code repositories; omit NAME for all
local-rag index project [NAME]                   Index project(s) from config; omit NAME for all
local-rag index all                              Index all configured sources

local-rag prune [COLLECTION]     Remove sources whose originals are gone; omit COLLECTION for all
local-rag prune --vectors        Remove orphaned embeddings (vectors with no surviving document)

local-rag search QUERY [flags]

Flags:
  -c, --collection STRING   Filter by collection name
      --type STRING         Filter by source type (markdown, pdf, email, code, ...)
      --path STRING         Filter by source path (case-insensitive substring, e.g. a subfolder or repo)
      --from STRING         Filter by email sender
      --author STRING       Filter by book author
      --after YYYY-MM-DD    Only results after this date
      --before YYYY-MM-DD   Only results before this date
  -m, --meta KEY=VALUE      Filter by metadata field (repeatable)
      --top INT             Number of results (default: 10)

local-rag collections list                       List all collections with counts
local-rag collections info NAME                  Show collection details
local-rag collections delete NAME [-y]           Delete a collection and all its data
local-rag collections export NAME                Export collection metadata as JSON
local-rag collections paths list NAME            List configured paths for a collection
local-rag collections paths add NAME PATH...     Add paths to a collection in config
local-rag collections paths remove NAME PATH...  Remove paths from a collection in config
local-rag collections paths update NAME \        Rewrite path prefixes in-place
  --old-prefix OLD --new-prefix NEW              (config paths + source paths in DB)

local-rag collections paths update "Project Alpha" \
  --old-prefix ~/docs/specs --new-prefix ~/new-location/specs

local-rag graph rebuild                  Derive relations from indexed content
local-rag graph rebuild --origin NAME    Rebuild one origin, leaving the others alone
local-rag graph stats                    Edge counts by origin and relation, plus top hubs
local-rag neighbors SOURCE               What a source is connected to (id or path substring)

local-rag status            Database stats, collection counts, Ollama status
local-rag graph rebuild     Rebuild the relation graph (see above)
local-rag prune [NAME]      Remove stale sources (see Pruning above)
local-rag serve [--port N]  Start MCP server (stdio, or Streamable HTTP at /mcp on given port)
local-rag gui               Start menu bar app (default when no subcommand)
local-rag --version         Print version
local-rag -v, --verbose     Enable debug logging (global flag)

make build       # Build binary to bin/local-rag
make test        # Run tests (requires -tags sqlite_fts5)
make test-v      # Verbose tests
make lint        # golangci-lint
make tidy        # go mod tidy
make app         # Build macOS .app bundle
make dmg         # Build DMG installer
make clean       # Remove bin/

make build VERSION=1.2.3
bin/local-rag --version    # local-rag version 1.2.3

cmd/local-rag/       CLI entry point (Cobra) — one cmd_*.go per command group
internal/
  config/            Configuration loading and defaults
  db/                SQLite + sqlite-vec + FTS5 setup and migrations
  embeddings/        Ollama embedding client and host resolution
  chunker/           Text chunking strategies
  search/            Hybrid search engine (vector + FTS + RRF)
  parser/            File parsers (markdown, pdf, docx, epub, html, code, ...)
  indexer/           Source indexers, shared batching, pruning
  mcp/               MCP server (tools, Streamable HTTP, stdio)
  gui/               Fyne menu bar app, settings, log viewer
configs/
  config.example.json  Annotated configuration template
docs/                Architecture, hybrid search/RRF, relation graph, Ollama, eM Client schema
scripts/
  build-app.sh       Create macOS .app bundle
  build-dmg.sh       Create DMG installer
.github/workflows/
  release.yml        Tagged release build