Aletheia
Log in
Setup

Install Aletheia

Set up the Aletheia engine locally with predictable binaries, model downloads, and SDK wiring.

Prerequisites

Aletheia is built as a Rust service with optional SDK clients. For a smooth start, install Rust stable and keep at least 4GB free disk for model and index artifacts.

Use a dedicated workspace directory for cache and data files so benchmarks and local testing can be reset without touching your main development environment.

  • Rust toolchain (stable channel)
  • Git for fetching benchmark assets
  • Node 20+ if you are using the platform/docs UI
  • Python 3.10+ only if using the Python SDK examples

Build and first boot

The release build gives realistic performance for retrieval and reranking tests. Development builds are fine for functional checks but not for latency decisions.

  1. Clone the monorepo and open `Aletheia`.
  2. Build release binary with Cargo.
  3. Start the API server on loopback.
  4. Call `/health` before sending ingest/query traffic.
Build and run
cargo build --release
./target/release/aletheia --bind 127.0.0.1:3000 --data-dir ./.tm-data

SDK smoke test

After the server is healthy, run one ingest and one query through your preferred SDK. This validates auth headers, entity scoping, and transport behavior in one pass.

Minimal curl check
curl -sS http://127.0.0.1:3000/ingest \
  -H "content-type: application/json" \
  -d '{"entity_id":"user-123","textual_content":"I now drink tea instead of coffee."}'