Tellodb
Sign up

Section

Fundamentals

OverviewQuickstartInstallCore Concepts
Operations

Self-Hosting & BYOC

Run Tellodb in your own infrastructure. One binary, zero dependencies, full control. Or deploy in your cloud with our BYOC program.

Self-Hosted Core Engine

The Tellodb Core engine is a single Rust binary — download, run. No Docker required. No database to configure. Works on macOS, Linux, and Windows. Everything needed for agent memory is inside the binary: HNSW vector index, BM25F full-text search, typed knowledge graph, temporal KV store, and deterministic analytics vault.

Embeddings are handled locally via Candle (CPU/GPU) or ONNX Runtime. No external embedding API is needed. The engine works completely air-gapped.

Quick start (binary)
curl -L https://github.com/Tellodb/Tellodb/releases/latest/download/tellodb-x86_64-linux -o tellodb
chmod +x tellodb
export TEMPORAL_MEMORY_API_KEY=my-secret
export TEMPORAL_MEMORY_EMBEDDING_MODEL=BAAI/bge-small-en-v1.5
./tellodb
# Listening on http://localhost:3000
Docker
docker run -p 3000:3000 \
  -e TEMPORAL_MEMORY_API_KEY=my-secret \
  -e TEMPORAL_MEMORY_EMBEDDING_MODEL=BAAI/bge-small-en-v1.5 \
  -e TEMPORAL_MEMORY_DATA_DIR=/data \
  tellodb:latest (build from Dockerfile in repo)

Configuration

Binary Size

~45 MB

Statically linked. No runtime dependencies.

Startup Time

< 1s

Cold start, all indexes loaded.

Memory (100K obs)

~800 MB

Includes all indexes. Configurable retention.

Price

Free

Open source (Apache 2.0). No license fees.

  1. Set TEMPORAL_MEMORY_API_KEY: Any string used to authenticate all requests. Treat this like a database password.
  2. Choose an embedding model: Set TEMPORAL_MEMORY_EMBEDDING_MODEL to a HuggingFace model ID (e.g., BAAI/bge-small-en-v1.5). The model is downloaded on first run and cached locally.
  3. Set the data directory: TEMPORAL_MEMORY_DATA_DIR defaults to the current directory. All database files (.redb) and the vector index (.hnsw) are stored here.
  4. Bind address: TEMPORAL_MEMORY_HOST (default 0.0.0.0) and PORT / TEMPORAL_MEMORY_PORT (default 3000).
  5. Enable GPU: Build with --features gpu-cuda and set TEMPORAL_MEMORY_DEVICE=cuda.

Enterprise BYOC

For organizations requiring dedicated infrastructure with full data sovereignty, we offer a Bring Your Own Cloud (BYOC) program. You provide the cloud account (AWS, GCP, or Azure); we provide Terraform modules that provision the Tellodb Core instance in your VPC. The management plane only receives health metrics — your data never leaves your infrastructure.

BYOC includes: dedicated single-tenant instance, customer-managed encryption keys (CMEK), custom networking (VPC, PrivateLink), 99.95% uptime SLA, and priority support.

Contact enterprise@tellodb.com for a BYOC assessment and pricing.

  • Terraform modules for automated provisioning in AWS, GCP, and Azure.
  • Zero-access architecture — no SSH, VPN, or inbound network access required for operations.
  • Outbound-only connectivity to the management plane for health metrics.
  • Configurable retention policies, backup schedules, and disaster recovery.