Build from Source

Use this path for contributors and advanced local development.

Prerequisites

• Rust (stable)
• Node.js 20+
• pnpm

Platform-specific dependencies are listed in the repository README.

1. Clone

git clone https://github.com/frumu-ai/tandem.git
cd tandem

2. Install JS dependencies

pnpm install

3. Build engine binary

cargo build -p tandem-ai

This produces the tandem-engine binary from the tandem-ai package.

If you need browser automation from source as well:

cargo build -p tandem-browser

4. Run

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

In another terminal:

cargo run -p tandem-tui --bin tandem-tui

5. Development and testing references

• Engine Testing
• docs/ENGINE_TESTING.md
• docs/ENGINE_CLI.md

6. Build docs (Starlight)

From guide/:

pnpm install
DOCS_SITE_URL=https://docs.tandem.ac/ DOCS_BASE_PATH=/ pnpm build

Notes:

• Root-hosted docs (https://docs.tandem.ac/) should use DOCS_BASE_PATH=/.
• Reverse-proxy docs at a subpath on another host should use:

DOCS_SITE_URL=https://example.com/ DOCS_BASE_PATH=/docs/ pnpm build

• Whatever base path you build with, your proxy/static host must serve both:
  • <base>_astro/*
  • <base>pagefind/*