tandem-ai 0.4.0

Tandem engine service and CLI binary
tandem-ai-0.4.0 is not a library.

tandem-ai (tandem-engine)

TTTTT   A   N   N DDDD  EEEEE M   M
  T    A A  NN  N D   D E     MM MM
  T   AAAAA N N N D   D EEEE  M M M
  T   A   A N  NN D   D E     M   M
  T   A   A N   N DDDD  EEEEE M   M

What This Is

tandem-ai is the Rust crate that builds the tandem-engine binary.
It runs the headless Tandem runtime (HTTP + SSE APIs, tools, sessions, orchestration/agent workflows).

Build

From the workspace root:

cargo build -p tandem-ai

Run

Start the HTTP/SSE engine server:

cargo run -p tandem-ai -- serve --hostname 127.0.0.1 --port 39731

Disable memory embeddings for a server run:

cargo run -p tandem-ai -- serve --disable-embeddings

Enable cross-project global memory tools (opt-in):

TANDEM_ENABLE_GLOBAL_MEMORY=1 cargo run -p tandem-ai -- serve

The engine now auto-configures TANDEM_MEMORY_DB_PATH to the shared Tandem memory.sqlite path when unset, so connected apps/tools use the same local knowledge base.

On startup, the engine bootstraps default documentation knowledge from an embedded bundle compiled into the binary (engine/resources/default_knowledge_*). It re-ingests only when the embedded corpus hash changes. Use TANDEM_DISABLE_DEFAULT_KNOWLEDGE=1 to disable this behavior.

Canonical docs URLs attached to seeded chunks use: https://tandem.docs.frumu.ai/

Regenerate the embedded bundle after docs changes:

pnpm engine:knowledge:bundle

CI and release workflows enforce that the committed bundle stays in sync with guide/src/content/docs.

Run a one-off prompt:

cargo run -p tandem-ai -- run "What is the capital of France?"

List available providers:

cargo run -p tandem-ai -- providers

Verify Before Publishing

cargo check -p tandem-ai
cargo package -p tandem-ai

Related Packages

  • npm wrapper (prebuilt binaries): packages/tandem-engine
  • TUI crate: crates/tandem-tui

Documentation