Terraphim AI - Privacy-First Semantic Search Assistant

What Terraphim Does

Terraphim AI connects your knowledge across 29 integrated crates, searching through personal, team, and public repositories with semantic understanding.

Entirely Local

Every query, every index, every result stays on your machine. No telemetry. No external calls unless you choose to connect a source.

Knowledge Graphs

Builds structured relationships between your documents and concepts. Semantic matching through thesaurus-driven automata, not just keyword search.

Multiple Relevance Functions

Choose from TitleScorer, BM25, BM25F, BM25Plus, or TerraphimGraph. Each optimised for different query patterns and data shapes.

Haystack Integrations

Connect local files, Confluence, Jira, Discourse forums, email via JMAP, and more. Each source becomes a searchable haystack in your graph.

Role-Based Profiles

Define roles with specific knowledge domains and search preferences. Switch contexts without losing your configuration or graph state.

How It Works

Terraphim processes your documents through a pipeline of concept extraction, graph construction, and semantic indexing. The result is search that understands relationships, not just words.

The system handles 5 relevance algorithms and connects across 8+ data source types, building a personalised knowledge graph for each role you define.

Quick Start

          cargo build --release
cargo run -- --config terraphim_engineer_config.json

# In another terminal
cd desktop && yarn install && yarn dev
        

Terraphim runs as a Rust backend with a Svelte desktop frontend. The server exposes a clean API for search, configuration, and chat. The desktop application provides real-time search, knowledge graph visualisation, and role management.

Search via API

          POST /documents/search
{
  "search_term": "semantic indexing",
  "role": "Terraphim Engineer"
}

# Returns ranked documents with
# concept-expanded results
        

Get Started

Terraphim is open source. Clone the repository, build with Cargo, and start searching your knowledge within minutes. No account required. No cloud dependency.

          git clone https://github.com/terraphim/terraphim-ai
cd terraphim-ai
cargo build --release
./target/release/terraphim-agent
        

For the full desktop experience with the Tauri application, the TUI with interactive REPL, or Firecracker VM integration for secure execution, see the project documentation.

TERRAPHIM