Agent templates
When you create a project in the dashboard, you pick an agent template. Templates with a pre-built bundle are seeded on create — the platform uploads and promotes a starter agent.js from the public @voicethere/agent package. Choose blank when you will build and upload your own bundle from scratch.
The CLI does not accept a --template flag on projects create. Use the dashboard picker for seeded starters, or copy a template locally and deploy with the CLI.
Where to configure
- Dashboard: Create project → Template dropdown. Optional toggles: relay speech events, chat enabled, voice enabled, echo prefix.
- CLI: No template selector — create with
voicethere projects create, then build, upload, promote, and deploy your bundle.
Template catalog
| Id | Seeded on create | Summary |
|---|---|---|
blank | No | Empty project — you upload your first build. |
voice-starter | Yes | Starter agent covering every speech event type. |
echo | Yes | Echo debug — voice finals plus DataChannel chat. |
echo-dc | Yes | Data-channel echo only — no TTS. |
game-sync | Yes | Authoritative multi-object sync sample for real-time games. |
Create-time options
Dashboard template settings (stored on the project):
relay_speech_events— forward speech pipeline events to the agent (default on).chat_enabled— DataChannel text chat path.voice_enabled— voice / STT/TTS path.echo_prefix— prefix for echo templates (e.g.you said:).
Local copy from @voicethere/agent
Product templates live under templates/<id>/ in the agent repo. Clone or browse:
git clone https://github.com/voicethere/agent.git cd agent npm install npx @voicethere/agent build --entry templates/echo/agent.ts --outfile dist/agent.js
Build, verify, upload, deploy
# In your agent repo (linked with voicethere projects use) npm install @voicethere/agent @voicethere/cli npx @voicethere/agent build --entry src/agent.ts --outfile dist/agent.js voicethere build validate voicethere build upload -m "From echo template" voicethere build list voicethere build promote <build-uuid> voicethere deploy --wait
deploy --wait promotes when needed and rolls the active build to cloud runners. See Quickstart for the full path.