Installation

Tone runs as a Docker Compose stack on your machine and as a Helm chart in production. This page covers local install.

Requirements

• Docker 24+ with Compose v2
• 8 GB RAM, 4 cores recommended
• A Twilio account for the phone integration (optional for local dev)

Install

Clone the repo and start the stack:

git clone https://github.com/tonehq/tone
cd tone
docker compose up -d

Tone is now running at http://localhost:3000. The first start takes 2-3 minutes to pull images and seed the database.

Verify

Check that all services are healthy:

docker compose ps

You should see api, worker, postgres, redis, and clickhouse all in the Up state.

Next steps

You're ready to build your first agent. The next page walks through configuring it and pointing a phone number at it.