condensate docs
Start here / Condensate

Run locally

Start the runtime, open Dex, and verify each connection.

Condensate is currently a developer preview. The source repository is private; this setup guide requires repository access. The public documentation and interactive product demo are available to read without an account.

This guide starts the runtime and Dex from a local checkout.

Install dependencies

Use the Bun version pinned in the root package.json (currently 1.3.13).

git clone https://github.com/condensate-dev/condensate.git
cd condensate
bun install --frozen-lockfile

Start the runtime

In a terminal at the repository root:

bun run --cwd packages/agents-host start

The default listener is http://127.0.0.1:4741. The default data directory is ~/.condensate/agents-host; it contains threads.db and large-payload storage. Do not point a second runtime at the same live data directory.

Check the connection

curl -fsS 'http://127.0.0.1:4741/threads?limit=5'
curl -fsS http://127.0.0.1:4741/workspaces

A successful read confirms that the runtime answers. An empty thread list is normal on a fresh installation. It does not confirm that a model account is configured.

Open Dex

In a second terminal at the repository root:

bun run --cwd apps/dex-app dev

Open http://127.0.0.1:5189. Dex forwards runtime requests to port 4741. Configure accounts and a workspace before expecting a new model task to run.

Add repository review

The review hub is a separate service. Its default port is 4700. From the repository root:

cd apps/gt-review
bun run build
bun run build:webapp
GTR_REVIEW_AGENTS=0 bun dist/cli.js hub --no-open

From another terminal in apps/gt-review, register a checkout:

bun dist/cli.js register /absolute/path/to/checkout

GTR_REVIEW_AGENTS=0 disables the hub's automatic reviewer start path for this startup. Repository review and runtime chat have separate upstreams; a working chat does not establish that the hub is running.

Read these docs locally

bun run docs:dev

Open http://127.0.0.1:5192. The docs server serves static documentation only and does not connect to your agents or credentials.

Condensate developer documentation · Source ba6d28952e