Dpro-at/Tel-Agent

What is it?

Key features

• 01Answers SIP phone calls in real time with streaming speech recognition and synthesis.
• 02Routes calls by caller ID to a human, a block, or an AI agent.
• 03Lets the agent invoke tools such as call transfer, messages, calendar checks and HTTP requests.
• 04Stores call recordings and transcripts that can be searched.
• 05Handles SMS, email, web chat and major messaging apps with the operator's own credentials.
• 06Runs self-hosted with API keys encrypted at rest and a required admin password on first run.

Use cases

• Answering business phone lines with an AI receptionist that can take messages or transfer to staff.
• Keeping call recordings and transcripts on your own servers instead of a hosted service.
• Serving one AI assistant across phone, SMS, email and chat channels for customer contact.
• Connecting an existing 3CX, Asterisk or FreePBX system to an AI agent as an extension.

Quick start

1. 1

   Clone the repository

   git clone https://github.com/Dpro-at/Tel-Agent.git
2. 2

   Enter the project folder

   cd Tel-Agent
3. 3

   Copy the example environment file

   cp .env.example .env
4. 4

   Set ENCRYPTION_KEY in .env (generate one with openssl), then start the containers

   docker compose up -d --build

Things to know

• !The project is in alpha stage.
• !The installers are unsigned, so the operating system will ask for confirmation before running them.
• !The phone channel needs API keys for speech-to-text, an LLM and text-to-speech providers, and a SIP line or PBX.
• !Local models need a GPU to hold a natural conversation and are not the default.

Topics

FAQ

What is Tel-Agent?

Self-hosted gateway that connects phone lines and chat channels to AI agents, using your own API keys. Tel-Agent sits between a phone line and an AI agent. Incoming SIP calls are checked against routing rules and either passed to a human, blocked, or handed to an AI agent that answers in real time. The agent can call tools such as transferring the call, taking a message, checking a calendar, or calling an HTTP endpoint, and calls are recorded, transcribed and searchable.

Is Tel-Agent free to use? What license does it have?

Tel-Agent is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is Tel-Agent still maintained?

Actively maintained. The last commit to Tel-Agent was on Oct 8, 2026.

What can I use Tel-Agent for?

Answering business phone lines with an AI receptionist that can take messages or transfer to staff. Keeping call recordings and transcripts on your own servers instead of a hosted service. Serving one AI assistant across phone, SMS, email and chat channels for customer contact. Connecting an existing 3CX, Asterisk or FreePBX system to an AI agent as an extension.

How do I install Tel-Agent?

Clone the repository: git clone https://github.com/Dpro-at/Tel-Agent.git Enter the project folder: cd Tel-Agent Copy the example environment file: cp .env.example .env Set ENCRYPTION_KEY in .env (generate one with openssl), then start the containers: docker compose up -d --build

Where can I get Tel-Agent?

The source code and installation instructions are on GitHub: https://github.com/Dpro-at/Tel-Agent