phone-agent

Run a real-time AI phone agent with Twilio, Deepgram, OpenAI, and ElevenLabs.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/delorenj/00_ceiling --skill phone-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phone-agent
Source: https://github.com/delorenj/00_ceiling/tree/main/phone-agent
Command: npx skills add https://github.com/delorenj/00_ceiling --skill phone-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastapi, uvicorn[standard], python-multipart, twilio, deepgram-sdk, openai, websockets, python-dotenv, requests, pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the handling of incoming phone calls, allowing for real-time voice conversations powered by AI, transcription, and text-to-speech.

Core Features & Use Cases

  • Real-time Call Handling: Answers and interacts with callers using natural language.
  • Speech-to-Text & Text-to-Speech: Transcribes caller audio and generates spoken responses.
  • AI-Powered Conversation: Leverages LLMs for intelligent dialogue and task completion.
  • Use Case: Set up an automated customer service line that can answer frequently asked questions, book appointments, or gather information from callers without human intervention.

Quick Start

Use the phone-agent skill to handle incoming calls with an AI assistant.

Frequently Asked Questions about phone-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate real-time AI voice calls with Twilio?

You can automate real-time AI voice calls with Twilio by deploying a FastAPI backend that handles Twilio webhooks, processes audio streams via websockets, and generates AI responses using OpenAI and ElevenLabs.

What API keys do I need to set up an AI phone agent?

You need API keys for Twilio, Deepgram, OpenAI, and ElevenLabs to handle call routing, speech transcription, conversational AI, and text-to-speech generation for the phone agent.

Do I need ngrok to expose webhooks for Twilio voice integration?

Yes, you need a tool like ngrok to expose your local FastAPI server publicly so Twilio can send inbound call webhooks and audio streams to your AI phone agent.

Can I make outbound calls with an AI conversational agent?

Yes, the phone agent supports outbound call initiation for task-based automation, allowing the AI conversational agent to make calls and interact with recipients using natural language.

How does speech-to-text transcription work during an AI phone call?

Speech-to-text transcription during an AI phone call works by streaming caller audio via websockets to Deepgram, which transcribes the speech in real-time for OpenAI to process and respond.

What are the limitations of using FastAPI for conversational AI phone automation?

Limitations of using FastAPI for conversational AI phone automation include the need for continuous public network exposure for Twilio webhooks and managing real-time websocket connections for low-latency audio streaming.