# Deploy a self-hosted phone-call agent for Asterisk and FreePBX with AVA

> Bring up a self-hosted voice agent that answers, routes, or transfers live calls through Asterisk or FreePBX with a PBX-native workflow.

- Skill: `agentskillexchange/deploy-a-self-hosted-phone-call-agent-for-asterisk-and-freep` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/deploy-a-self-hosted-phone-call-agent-for-asterisk-and-freep`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/deploy-a-self-hosted-phone-call-agent-for-asterisk-and-freep/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/deploy-a-self-hosted-phone-call-agent-for-asterisk-and-freep

---


# Deploy a self-hosted phone-call agent for Asterisk and FreePBX with AVA

Bring up a self-hosted voice agent that answers, routes, or transfers live calls through Asterisk or FreePBX with a PBX-native workflow.

## Prerequisites

Docker Compose, Asterisk or FreePBX environment, telephony configuration, STT/LLM/TTS provider credentials

## Installation

Use the upstream install or setup path that matches your environment:
- git clone https://github.com/hkjarral/Asterisk-AI-Voice-Agent.git
- docker compose -p asterisk-ai-voice-agent up -d --build --force-recreate admin_ui
- docker compose -p asterisk-ai-voice-agent up -d --build ai_engine
- docker compose -p asterisk-ai-voice-agent logs ai_engine | tail -20

Requirements and caveats from upstream:
- ![Python](https://img.shields.io/badge/python-3.11+-blue.svg)
- ![Docker](https://img.shields.io/badge/docker-compose-blue.svg)
- **GPU users:** If you have an NVIDIA GPU for local AI inference, see **[docs/LOCAL_ONLY_SETUP.md](docs/LOCAL_ONLY_SETUP.md)** for the GPU compose overlay (docker-compose.gpu.yml) before building.

Basic usage or getting-started notes:
- [Quick Start](#-quick-start) • [Features](#-features) • [Roadmap](docs/ROADMAP.md) • [Demo](#-demo) • [Docs](docs/README.md) • [Community](#-community)
- ## 🚀 Quick Start
- ### 1. Run Pre-flight Check (Required)

- Source: https://github.com/hkjarral/AVA-AI-Voice-Agent-for-Asterisk
- Extracted from upstream docs: https://raw.githubusercontent.com/hkjarral/AVA-AI-Voice-Agent-for-Asterisk/HEAD/README.md

## Documentation

- https://github.com/hkjarral/AVA-AI-Voice-Agent-for-Asterisk

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/deploy-a-self-hosted-phone-call-agent-for-asterisk-and-freepbx-with-ava/)