语音代理构建

Prerequisites

• Python 3.10 or higher (download from python.org. Verify with python --version)
• Node.js 18.18+ (Node 20+ recommended for Next.js 15)
• PostgreSQL 14+
• Docker (optional)

🎙️ Open Source AI Voice Agent Builder

License: MIT Python FastAPI React PostgreSQL

The open source alternative to Retell, Synthflow, and Vapi - Build reliable, observable, and easily testable AI voice agents with a focus on developer experience.

Installation

1. Clone the repository

   git clone https://github.com/tonehq/tone.git
   cd tone
  

   # Create a .env file in the project root with:
   #   DATABASE_URL=postgresql://<user>:<password>@<host>/<dbname>
   #   JWT_SECRET_KEY=<your-secret-key>
   #   ENCRYPTION_KEY=<your-encryption-key>
   #
   # Infisical (used by bootstrap/dev-bootstrap.sh and to run the app):
   #   INFISICAL_PROJECT_ID=<your-project-id>
   #   INFISICAL_ENV=<staging|dev|production>
   #
   # Cloudsmith (private tone-pipecat package):
   #   PIP_EXTRA_INDEX_URL=https://<user>:<token>@dl.cloudsmith.io/<entitlement>/tonehq/tone/python/simple/
   #
   # Optional: provider API keys (OPENAI_API_KEY, DEEPGRAM_API_KEY, etc.)
  

   # macOS
   brew install infisical/get-cli/infisical

   # Linux
   curl -1sLf 'https://artifacts-cli.infisical.com/setup.deb.sh' | sudo -E bash
   sudo apt install -y infisical

   # Log in once (opens a browser)
   infisical login
  

   # Get the real URL from Cloudsmith → tonehq/tone repo → Set Me Up → Python.
   export PIP_EXTRA_INDEX_URL="https://<user>:<token>@dl.cloudsmith.io/<entitlement>/tonehq/tone/python/simple/"
  

Option A — One-command setup (recommended)

Runs Python install, venv, dependencies, migrations, procrastinate schema, DB seed, Node.js install, and frontend npm install — all in one go.

Before running: open bootstrap/dev-bootstrap.sh and read the PREREQUISITES block at the top. It lists everything you must have in place first (Homebrew, PIP_EXTRA_INDEX_URL, infisical login, .env keys, a reachable Postgres DB, optional provider API keys). The seed step is interactive — have your organization name, owner email, and password ready.

./bootstrap/dev-bootstrap.sh

Adding another organization on an already-initialized DB? See Adding a new organization below.

When it finishes, start the servers:

```bash

Docker Setup

```bash

Build the backend image

docker build -f core/Dockerfile -t tone .

🚀 Quick Start

Local — reads DATABASE_URL from .env

./bootstrap/db-bootstrap.sh

Same, but also seeds provider API keys from env vars

Run it (expects DATABASE_URL and other env vars to be provided)

docker run --rm -p 8000:8000 --env-file .env tone ```

With Infisical (DATABASE_URL and provider API keys injected from Infisical)

infisical run --projectId "$INFISICAL_PROJECT_ID" --env="$INFISICAL_ENV" -- \ ./bootstrap/db-bootstrap.sh ```

Prerequisites (also listed at the top of bootstrap/db-bootstrap.sh): - Python venv activated with dependencies installed - A reachable, empty Postgres DB — DATABASE_URL in .env (or injected by infisical run) - Optional: provider API keys in env (OPENAI_API_KEY, etc.) if you want them seeded automatically

The seed step is interactive — have organization name, owner email, and password ready.

Prompts for org name, owner email, password. Skips API keys.

./bootstrap/org-bootstrap.sh

(OPENAI_API_KEY, DEEPGRAM_API_KEY, ELEVENLABS_API_KEY, etc.)

./bootstrap/org-bootstrap.sh --api-keys-from-env

API Structure

Our codebase follows a clean architecture pattern:

core/
├── api/v1/              # FastAPI route handlers
│   ├── agents.py
│   ├── auth.py
│   ├── channels.py
│   ├── models.py
│   ├── organizations.py
│   ├── service_providers.py
│   └── voices.py
├── services/            # Business logic layer
│   ├── agent_service.py
│   ├── agent_factory_service.py
│   ├── voice_service.py
│   ├── channel_service.py
│   └── model_service.py
├── models/              # SQLAlchemy ORM models
│   ├── agent.py
│   ├── organization.py
│   ├── service_provider.py
│   ├── voice.py
│   └── user.py
├── middleware/           # Auth & request middleware
│   └── auth.py
├── utils/               # Utility functions
│   └── encryption.py    # AES encryption for API keys
├── bot.py               # Voice pipeline entry point
└── database/            # DB session & connection
dev/
├── seed.py              # Data seeding script
└── dev-data.json        # Provider/model/voice definitions