Voice agent quickstart
Updated
Build a working voice agent in under five minutes without writing any server code by cloning an officially maintained starter project.
Set up a working voice agent in under five minutes. This page walks you through installing the Agora skills to give your AI coding assistant the official quickstarts and Agora CLI workflows. You then use the CLI to log in, clone the official starter, and run it locally. You can follow the CLI steps yourself or paste the sample prompt and let your assistant handle setup for you.
Install Agora skills
Agora skills teaches your AI coding assistant how to work with Conversational AI projects using official starter repos and the Agora CLI, including signing in, project binding, generating environment files, and running diagnostics. Install the CLI in the next section, or ask your assistant to run the installer for you.
npx skills add AgoraIO/skillsPaste the following prompt into your assistant's chat. You can replace Python with TypeScript or Go depending on your language preference:
Set up and run the Agora Conversational AI Python starter project locally.Your assistant installs the CLI, signs you in, scaffolds the official starter, and guides you through the remaining steps. Follow the manual CLI steps below if you prefer to run each command yourself.
Install the Agora CLI
The Agora CLI is a native Go binary available at AgoraIO-Community/cli.
curl -fsSL https://dl.agora.io/cli/install.sh | sh
agora --helpIf the agora command is not found after installation, re-run with --add-to-path or
manually add the install directory to your shell profile.
irm https://dl.agora.io/cli/install.ps1 | iex
agora --helpIf your execution policy blocks inline scripts, download install.ps1 and run:
powershell -ExecutionPolicy Bypass -File .\install.ps1Sign in, scaffold, and run
Sign in with the Agora CLI, clone the starter project, and configure it for your chosen language.
-
Sign in to Agora Console.
agora login -
Use
agora initto clone the official starter for your chosen template, bind it to your Agora project, and write the runtime-specific environment file.
agora init my-python-demo --template python
cd my-python-demo
bun install
bun run devagora init my-nextjs-demo --template nextjs
cd my-nextjs-demo
pnpm install
pnpm devagora init my-go-demo --template go
cd my-go-demo
make setup
make dev- Open
http://localhost:3000and click Start conversation.
If the agent does not join or transcripts do not appear, run agora project doctor to
check credential validity, feature enablement, and network reachability.
Next steps
Explore the following topics:
- Start and stop an agent: Create and end a voice agent session with the REST API.
- Use managed mode: Start with Agora-managed ASR, LLM, and TTS providers.
- Optimize conversation latency: Tune ASR, LLM, TTS, and deployment choices.
- Optimize audio: Apply recommended client audio settings.
- REST API reference: Review exact request and response shapes.
- Explore the SDK API references for TypeScript, Python, and Go.