tandem-ai 0.4.7

Tandem engine service and CLI binary
tandem-ai-0.4.7 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

Standard installs should set only TANDEM_STATE_DIR and keep all Tandem runtime files under that one root. The engine will then use:

  • <TANDEM_STATE_DIR>/memory.sqlite
  • <TANDEM_STATE_DIR>/config.json
  • <TANDEM_STATE_DIR>/storage/...
  • <TANDEM_STATE_DIR>/logs/...

TANDEM_MEMORY_DB_PATH remains available as an advanced override, but using a separate memory DB path from the main Tandem state root is no longer the recommended setup.

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