Terraphim
v1.16.0
Terraphim
Home Capabilities How-tos Docs Rust Releases Install Donate
Local-First Knowledge Navigation

Navigate Your
Knowledge at
Warp Speed

Terraphim is a local-first knowledge graph search engine built in Rust and WebAssembly. Your data never leaves your machine. Aho-Corasick pattern matching across role-based knowledge graphs, at native speed.

Install terraphim-agent
$ cargo install terraphim-agent
or Homebrew, curl, binary downloads
Quickstart v1.16.31 release GitHub

Hyperdrive Charge

0%
Search Latency < 1ms
Pattern Engine Graph Embeddings
Runtime WASM + Native
Workspace Crates 52+
Telemetry Zero
Navigation Waypoints

Core Capabilities

Nine capabilities the engine ships with today. Each waypoint links to its detailed page.

WP-001

Local-First Architecture

Your data never leaves your machine. Indexing, searching, and graph traversal all happen on-device. No cloud, no exfiltration, no telemetry.

Explore capability
WP-002

Graph Embeddings

Deterministic, explainable graph-based embeddings. No neural vectors, no GPUs. Every match traces back to a concept in the thesaurus.

Explore capability
WP-003

Knowledge Graph Engine

Role-configured knowledge graphs with Aho-Corasick multi-pattern matching. Thousands of patterns matched simultaneously in a single pass.

Explore capability
WP-004

terraphim-agent CLI

Search-first AI agent. Session search across Claude Code and Cursor history, learning capture from failed commands, command rewriting via thesaurus.

Explore capability
WP-005

MCP Server

Native Model Context Protocol server. Connect your AI assistant to local knowledge graphs. KG-boosted file search, token tracking, role-based context.

Explore capability
WP-006

Hooks System

Pre and post tool-use hooks for AI coding assistants. Capture failed commands, inject knowledge graph context, automate learning from sessions.

Explore capability
WP-007

Multi-Haystack Search

One query, many sources. Search local files, Confluence, Jira, Discourse, email, and global code via grepapp — ranked by the role's knowledge graph.

Explore capability
WP-008

KG-Boosted File Search

File search augmented with knowledge graph context. Find files by their semantic relationship to domain concepts and role-specific vocabulary.

Explore capability
WP-009

Rust / WASM Runtime

Written in Rust, compiled to WebAssembly. Sub-millisecond search. Memory-safe, thread-safe, running at near-native speed in browser or desktop.

Explore capability

Curious how it started? Read the origin story — from The Pattern (Redis Hackathon Platinum winner) through Kaggle and Oxford to Terraphim AI.

Honest Comparison

What You Keep vs What They Take

Feature-by-feature: Terraphim (local) vs typical cloud search products.

Capability Terraphim Cloud
Runs on your hardware
Data stays on device
Works offline
Zero telemetry
No account required
No API key
Open source
Knowledge graphs
MCP integration
Role-based profiles
Multi-source indexing
Token usage tracking
Vendor lock-in
Recurring subscription
Tally 12 / 2 3 / 11
= yes   = no   = partial   // rows 13-14: lower is better
System Readouts

Ship Systems

What the engine actually does, with numbers from the benchmark suite.

Computation Core

Rust compiled to native or WebAssembly. Aho-Corasick automata match every pattern in a single pass — O(n) in text length, independent of pattern count.

Inference 5-10 ns
Search query < 1 ms
Index throughput ~310 MiB/s

Memory Subsystem

No float vectors, no dense embeddings, no GPU allocation. Rust's zero-cost abstractions, deterministic allocation, graphs held in compressed representations.

Graph footprint 15-20 MB
Index build (100 terms) ~301 µs
Index build (1,000 terms) ~3.66 ms

Privacy Shield

All operations execute locally. No network calls for search, indexing, or graph traversal. Your data never leaves the device.

Network calls (search) 0
Telemetry None
Third-party services None required
What runs on your box
Search engineAho-Corasick
Graph engineRoleGraph
Agent protocolMCP server
RuntimeRust + WASM
Hook systemNative
DeploymentDesktop / CLI / Server
Measured performance
Inference5-10 ns
Search latency< 1 ms
Index 100 terms~301 µs
Index 1,000 terms~3.66 ms
Graph RAM15-20 MB
Privacy posture
Data at restLocal
Network accessNone required
Account requiredNo
LicenceApache-2.0 OSS

Last measured from Criterion benchmarks in crates/terraphim_automata/benches. Run them yourself: cargo bench.

Crew Stations

Role-Based Knowledge Graphs

Each role brings its own vocabulary, relationships, and domain expertise.

System Operator

Infrastructure and operations focused. Monitors system health, manages deployments, navigates operational knowledge spanning runbooks, incident reports, and system documentation.

Infrastructure Monitoring Runbooks Incidents

Engineer

Design and development focused. Traverses codebases, API documentation, architecture decision records, and technical specifications through domain-specific pattern matching.

Architecture APIs Code Specifications

Analyst

Research and intelligence focused. Navigates across datasets, reports, and analytical frameworks. Discovers hidden connections between concepts using multi-pattern graph queries.

Research Reports Datasets Intelligence
Launch Platforms

Deploy Everywhere

One engine. Eight deployment targets. Always local-first.

Command Line

Install terraphim-agent and terraphim-cli from Cargo, Homebrew, or curl. Native Rust, zero runtime deps.

Rust CLI

Desktop Application

Native Tauri desktop app. Full system integration, file-system access, offline-first. Separate repository.

Tauri

HTTP Server

REST API for search, config, chat, and document management. Integrates with Confluence, Jira, Discourse, email, local files, and grepapp.

REST API

MCP Server

Model Context Protocol server for Claude, Cursor, and any MCP-capable assistant. Exposes search, role-aware KG context, and token tracking.

MCP

Browser Extension

Knowledge graph search in your browser, WASM-powered, runs in the extension sandbox. Install now.

WASM

Node / npm

@terraphim/autocomplete on npm. Aho-Corasick matching and knowledge-graph autocomplete for Node and browser apps, compiled to WASM.

npm + WASM

Python

terraphim-automata on PyPI. Python bindings to the Aho-Corasick automata crate via PyO3. Drop-in for data pipelines and notebooks.

PyO3

Edge & Embedded

15-20 MB graph footprint runs on Raspberry Pi, edge devices, and modest cloud instances. Docker and Debian packages available from each release.

ARM64 / Debian
Get Started

Install Terraphim

One command. No sign-up. No API key. Choose your platform.

Install the Application

Quick Install

$ curl -fsSL https://raw.githubusercontent.com/terraphim/terraphim-ai/main/scripts/install.sh | bash

Homebrew

$ brew tap terraphim/terraphim && brew install terraphim-ai

Cargo

$ cargo install terraphim-agent
$ cargo install terraphim-cli

Windows

> curl -fsSL https://raw.githubusercontent.com/terraphim/terraphim-ai/main/scripts/install.sh | bash

Requires WSL. Or download the .zip directly.

Library Bindings

Embed Terraphim's autocomplete and knowledge graph engine in your own applications.

Node.js / Bun

$ npm install @terraphim/autocomplete

Native NAPI bindings for autocomplete and knowledge graph search.

Python

$ pip install terraphim-automata

PyO3 bindings for text matching and autocomplete. Python 3.9+.

Browser Extension

WASM-powered knowledge graph search in your browser. Coming to Chrome Web Store. Install in developer mode.

Download v1.16.31 Installation Guide