Streaming Telephony Framework

Ranya

Enterprise‑grade voice agents for real calls: deterministic pipelines, safe tool execution, and first‑class observability.

Start Here Task Flows

GitHub Repository Star Fork

What You Can Build

• Inbound support lines
  Barge‑in safe, fast routing, stable latency.

• Outbound call flows
  Reliable turn state, interruption handling.

• Tool‑powered voice agents
  Confirmed actions with retries and idempotency.

• Multi‑language deployments
  Language detection and per‑provider routing.

Top Tasks

• Get a Call Working
  Run the reference and verify end‑to‑end flow.
  Task 1: Get a Call Working

• Add Tools
  Define tool schemas and confirmations.
  Task 2: Add Tools

• Add Routing + Language
  Route agents and detect language early.
  Task 3: Add Routing + Language

• Enable Observability
  Add artifacts, trace IDs, and debug timelines.
  Task 4: Enable Observability

Decision Points That Matter

• Latency vs completeness: pipeline.backpressure and queue sizes.
  Pipeline and Backpressure

• Barge‑in behavior: turn.min_barge_in_ms and reprompts.
  Turn Management

• Tool safety: confirmation mode and timeouts.
  Tools and Confirmation

• Routing strategy: router.mode and language detection.
  Routing and Language

• Debug strategy: enable artifacts and trace IDs.
  Observability

Data Flow (High‑Level)

flowchart LR Caller((Caller)) Transport --> STT --> Turn --> Context --> Router --> LLM --> ToolDispatcher --> LLM --> TTS --> Transport Caller --> Transport Transport --> Caller Observers -.-> STT Observers -.-> LLM Observers -.-> TTS