cloudflare / cloudflare/cloudflare-docs

Realtime Agents SDK - failed to start pipeline error

Open
#29,484 1 comment 0 reactions 1 assignee Claimed by @renandincer View on GitHub
product:realtime stale
Dominant language
MDX
Stars
5.2k
Forks
16.7k
Avg merge
2d 6h
Merged PRs (30d)
337

Description

### Example URL(s)

- https://developers.cloudflare.com/realtime/agents/getting-started/

### Actual Behavior

Hey! 👋 I'm following the Realtime Agents getting started guide and running into an issue.

Error: failed to start pipeline

What I've done:
✅ Deployed the Worker successfully
✅ Set all 4 secrets: ACCOUNT_ID, API_TOKEN (Realtime Admin scope), DEEPGRAM_API_KEY, ELEVENLABS_API_KEY
✅ Added nodejs_compat flag, AI binding, Durable Object + migrations in wrangler.jsonc
✅ Joined the meeting myself before calling /init
✅ Generated two separate authTokens (one for me, one for the agent)
✅ Tested Deepgram and ElevenLabs API keys directly — both return 200 OK
✅ ACCOUNT_ID is the Cloudflare Account ID
Curl command:
curl -X POST "https://.workers.dev/init?meetingId=" -H "Authorization: Bearer "

Log error:
{ "message": "failed to start pipeline", "exception": { "name": "Error", "message": "failed to start pipeline" } }

Is this a known issue with the experimental Realtime Agents SDK? Any idea what could be causing this? Thanks!

### Expected Behavior

Calling `this.initPipeline()` with valid credentials (Cloudflare Account ID,
Realtime Admin API Token, Deepgram API Key, ElevenLabs API Key, and a valid
RealtimeKit authToken) should successfully initialize the agent pipeline and
allow the agent to join the meeting via `RealtimeKitTransport`.

The agent should then:
1. Connect to the RealtimeKit meeting
2. Start transcribing audio using DeepgramSTT
3. Process transcripts via the TextComponent
4. Speak responses using ElevenLabsTTS
5. Return HTTP 200 from the /init endpoint

### Additional information

_No response_

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.