Skip to content
Back to search

Tel-Agent

AI phone assistant | open-source

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dpro-at--tel-agent/badge.svg)](/listings/dpro-at--tel-agent)

HTML

<a href="/listings/dpro-at--tel-agent"><img src="/api/listings/dpro-at--tel-agent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/Dpro-at/Tel-Agent.git
cd Tel-Agent
cp .env.example .env
# set ENCRYPTION_KEY in .env - generate one with: openssl rand -hex 32
docker compose up -d --build

Then open **http://localhost:38471**. The first visit creates the administrator — there are no default credentials. The API and its documentation are on http://localhost:38472/docs, and conversations live on the `tel-agent-data` volume (SQLite by default; a `postgres` profile is in `docker-compose.yml`).

Every tagged release also publishes the images to GitHub Container Registry, so the build step can be skipped entirely: `docker compose -f docker-compose.release.yml up -d` — same layout, same volumes, interchangeable with the from-source file on one machine. If you would rather not run Docker at all, the [releases page](https://github.com/Dpro-at/Tel-Agent/releases/latest) has native installers for Windows, macOS and Linux.

Both ports are published on **loopback only**. Reaching the installation from other machines is a decision made in `.env` — the `TEL_AGENT_*` block there lists the three values to change and why the dashboard image is rebuilt for it. On a server, put a reverse proxy terminating TLS in front instead.

**Running it without Docker** stays supported and documented — contributors need to run the code without rebuilding an image on every edit. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for the manual run, [`docs/SPEC.md`](docs/SPEC.md) for the full design and [`CLAUDE.md`](CLAUDE.md) for the development rules.

Requirements for the phone channel

- API keys for an STT, an LLM, and a TTS provider (or a GPU for local models) - A machine on the same LAN as the PBX - Network access to the PBX on 5060/UDP and an open RTP port range - A SIP endpoint. Most lines already are one:

| Your line | What you need | Extra hardware | |---|---|---| | A PBX — 3CX, Asterisk, FreePBX | An extension on it | None | | A landline from an ISP | These are IP-based now. Either the provider gives you SIP credentials, or your router acts as a SIP registrar and you register against it — common with Fritz!Box in Austria and Germany | None | | A genuinely analog line — old copper, a fax line | An ATA to bridge it, e.g. a Grandstream HT801 | ~€30 |

Tel-Agent only ever speaks SIP. That is deliberate: supporting telephony hardware directly is a project of its own, and an ATA solves it for about the price of a cable.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 316 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="logo.png" alt="Tel-Agent" height="130">
  3. # AI phone assistant
  4. **Connect any phone line to any AI model. Self-hosted, bring your own keys.**
  5. <!-- Two rows of marks. The first is the channels that ship today (call and
  6. landline are two drawings of the one phone channel); the second is the wave-2
  7. channels being added now, tracked in the issues labelled "channel". The rows are
  8. about recognition, not arithmetic. -->
  9. <p>
  10. <img src="docs/brand/channels/call.svg" alt="Call" title="Call" height="26">
  11. &nbsp;&nbsp;
  12. <img src="docs/brand/channels/landline.svg" alt="Landline" title="Landline" height="26">
  13. &nbsp;&nbsp;
  14. <img src="docs/brand/channels/web-chat.svg" alt="Web chat" title="Web chat" height="26">
  15. &nbsp;&nbsp;
  16. <img src="docs/brand/channels/sms.svg" alt="SMS" title="SMS" height="26">
  17. &nbsp;&nbsp;
  18. <img src="docs/brand/channels/email.svg" alt="Email" title="Email" height="26">
  19. &nbsp;&nbsp;
  20. <img src="docs/brand/channels/whatsapp.svg" alt="WhatsApp" title="WhatsApp" height="26">
  21. &nbsp;&nbsp;
  22. <img src="docs/brand/channels/telegram.svg" alt="Telegram" title="Telegram" height="26">
  23. &nbsp;&nbsp;
  24. <img src="docs/brand/channels/messenger.svg" alt="Messenger" title="Messenger" height="26">
  25. &nbsp;&nbsp;
  26. <img src="docs/brand/channels/instagram.svg" alt="Instagram" title="Instagram" height="26">
  27. &nbsp;&nbsp;
  28. <img src="docs/brand/channels/discord.svg" alt="Discord" title="Discord" height="26">
  29. &nbsp;&nbsp;
  30. <img src="docs/brand/channels/slack.png" alt="Slack" title="Slack" height="26">
  31. </p>
  32. <p>
  33. <img src="docs/brand/channels/teams.svg" alt="Microsoft Teams" title="Microsoft Teams" height="26">
  34. &nbsp;&nbsp;
  35. <img src="docs/brand/channels/signal.svg" alt="Signal" title="Signal" height="26">
  36. &nbsp;&nbsp;
  37. <img src="docs/brand/channels/viber.svg" alt="Viber" title="Viber" height="26">
  38. &nbsp;&nbsp;
  39. <img src="docs/brand/channels/google-chat.svg" alt="Google Chat" title="Google Chat" height="26">
  40. &nbsp;&nbsp;
  41. <img src="docs/brand/channels/mattermost.svg" alt="Mattermost" title="Mattermost" height="26">
  42. &nbsp;&nbsp;
  43. <img src="docs/brand/channels/matrix.svg" alt="Matrix" title="Matrix" height="26">
  44. &nbsp;&nbsp;
  45. <img src="docs/brand/channels/irc.svg" alt="IRC" title="IRC" height="26">
  46. &nbsp;&nbsp;
  47. <img src="docs/brand/channels/line.svg" alt="LINE" title="LINE" height="26">
  48. &nbsp;&nbsp;
  49. <img src="docs/brand/channels/wechat.svg" alt="WeChat" title="WeChat" height="26">
  50. &nbsp;&nbsp;
  51. <img src="docs/brand/channels/wecom.svg" alt="WeCom" title="WeCom" height="26">
  52. &nbsp;&nbsp;
  53. <img src="docs/brand/channels/qq.svg" alt="QQ" title="QQ" height="26">
  54. &nbsp;&nbsp;
  55. <img src="docs/brand/channels/dingtalk.svg" alt="DingTalk" title="DingTalk" height="26">
  56. &nbsp;&nbsp;
  57. <img src="docs/brand/channels/feishu.svg" alt="Feishu / Lark" title="Feishu / Lark" height="26">
  58. &nbsp;&nbsp;
  59. <img src="docs/brand/channels/imessage.svg" alt="iMessage" title="iMessage" height="26">
  60. </p>
  61. <p>Connect them over MCP — and get full control.</p>
  62. <!-- Thirteen logos, one file per theme. Seven of them are single-colour marks, so the
  63. strip is built twice rather than recoloured live. See docs/brand/models/README.md. -->
  64. <p>
  65. <picture>
  66. <source media="(prefers-color-scheme: dark)" srcset="docs/brand/models/models-dark.svg">
  67. <source media="(prefers-color-scheme: light)" srcset="docs/brand/models/models-light.svg">
  68. <img src="docs/brand/models/models-light.svg" alt="Works with OpenAI, Claude, Gemini, Mistral, Ollama, Perplexity, Copilot, Manus, DeepSeek, Grok, Qwen, Groq and OpenRouter" height="28">
  69. </picture>
  70. </p>
  71. <!-- Two files, one seal. The wreath is single-colour artwork on a transparent
  72. background, so it needs dark ink on GitHub's light theme and white ink on the
  73. dark one; <picture> is what lets a README ship both. -->
  74. <p>
  75. <picture>
  76. <source media="(prefers-color-scheme: dark)" srcset="docs/brand/awards/product-of-the-day-dark.svg">
  77. <source media="(prefers-color-scheme: light)" srcset="docs/brand/awards/product-of-the-day-light.svg">
  78. <img src="docs/brand/awards/product-of-the-day-light.svg" alt="Product of the day - 1st" height="74">
  79. </picture>
  80. </p>
  81. <p>
  82. <img src="docs/brand/compliance/gdpr-dsgvo.png" alt="DSGVO & GDPR compliant" height="34">
  83. <img src="docs/brand/compliance/eu-ai-act.png" alt="EU AI Act compliant" height="34">
  84. </p>
  85. [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
  86. [![Status: alpha](https://img.shields.io/badge/status-alpha-blue.svg)](#project-status)
  87. [![Release](https://img.shields.io/github/v/release/Dpro-at/Tel-Agent?label=release)](https://github.com/Dpro-at/Tel-Agent/releases/latest)
  88. [tel-agent.com](https://tel-agent.com) · maintained by [Dpro GmbH](https://dpro.at), Vienna
  89. </div>
  90. ---
  91. ## What it is
  92. Tel-Agent is an open-source gateway that sits between a phone line and an AI agent.
  93. A call arrives over SIP. Tel-Agent checks the caller against your routing rules and
  94. either passes it through to a human, blocks it, or hands it to an AI agent. The agent
  95. speaks with the caller in real time, can invoke tools — transfer the call, take a
  96. message, check a calendar, call any HTTP endpoint — and every call is recorded,
  97. transcribed, and searchable.
  98. It runs on your own hardware, on your own LAN, with your own API keys.
  99. The same agent handles phone calls and answers
  100. on **web chat, SMS, email, WhatsApp, Telegram, Messenger, Instagram, Discord and
  101. Slack** — connected with your own credentials from each platform, never a shared
  102. application of ours. The official channel scope now covers **24 channels including the phone**, with additional channels built on the extension contract. A channel is a route a
  103. customer uses to reach you; a system you run your own business on is an integration,
  104. and those are reached through webhooks and the HTTP tool.
  105. ## What it is not
  106. - **Not a PBX replacement.** It connects to your existing PBX (3CX, Asterisk, FreePBX)
  107. as an extension.
  108. - **Not a workflow automation platform.** Webhooks and a generic HTTP tool reach n8n
  109. and Home Assistant, which do that job better. A *channel* is where the conversation
  110. happens; an *integration* is a system the agent acts on. We own the first and reach
  111. the second through the HTTP tool.
  112. - **Not a CRM.**
  113. - **Not analog-capable.** Bridge an analog line with an ATA; Tel-Agent only speaks SIP.
  114. ## Why it exists
  115. Well-funded closed products already do "AI receptionist for business". What does not
  116. exist is a good **open, self-hosted** one — where you own the recordings, choose the
  117. models, and decide which callers ever reach the AI at all.
  118. ---
  119. ## Project status
  120. **Alpha. Native installers and container images are available today.** Choose a platform on the [download page](https://tel-agent.com/download), or get the packages from the
  121. [releases page](https://github.com/Dpro-at/Tel-Agent/releases/latest): a Windows
  122. installer, macOS packages for Apple Silicon and Intel, DEB and RPM packages for Linux,
  123. and a `docker-compose.release.yml` that pulls the published images. The installers are
  124. unsigned while code signing is not yet configured, so the operating system will ask
  125. once before it runs.
  126. **What works now.** A conversation is answered end to end: the reply streams token by
  127. token, can be interrupted mid-sentence, is stored, and raises a notification so a person
  128. knows someone wrote in. The phone implementation includes streaming speech recognition and synthesis, interruption handling, caller-ID routing, and stored call transcripts through the SIP/LiveKit transport. Twilio integration handles SMS with customer-owned credentials. The core messaging channels are wired — web chat, WhatsApp, Telegram,
  129. Messenger, Instagram, Discord, Slack, email and SMS — and the dashboard serves them
  130. from a real API: sign-in and the account flows, home, the conversation archive, the
  131. notification tray, contacts, assistants, knowledge, the catalogue, apps, numbers,
  132. routing rules, backups, system health, settings and workspaces. The product speaks
  133. five languages: English, German, Arabic, Spanish and Dutch.
  134. **What is being added now.** A second wave of channels, one issue each under the
  135. [`channel` label](https://github.com/Dpro-at/Tel-Agent/issues?q=is%3Aissue%20state%3Aopen%20label%3Achannel):
  136. Microsoft Teams, Signal, Viber, Google Chat, Mattermost, Matrix, IRC, LINE, WeChat,
  137. WeCom, QQ, DingTalk, Feishu / Lark and iMessage. They share one declarative setup
  138. contract (#220), so each new channel is a definition plus a transport rather than a
  139. fork of the last one. More translations are open as
  140. [good first issues](https://github.com/Dpro-at/Tel-Agent/issues?q=is%3Aissue%20state%3Aopen%20label%3Ai18n).
  141. **Deployment.** The Windows installer starts the local service and opens the dashboard in your browser. Native macOS and Linux packages and Docker images provide the other installation paths. Phone and messaging connections use your own provider credentials; configure the channels you want to use in your installation.
  142. The full plan, and what each milestone means, is in [`docs/ROADMAP.md`](docs/ROADMAP.md).
  143. Watch or star the repository to hear when a release lands.
  144. ---
  145. ## Architecture
  146. | Layer | Choice |
  147. |---|---|
  148. | Voice agent | Python + [LiveKit Agents](https://github.com/livekit/agents) |
  149. | API | Python + FastAPI |
  150. | Frontend | Next.js + React |
  151. | Database | SQLite by default; PostgreSQL is also supported |
  152. | Cache / queue | Redis |
  153. | Reverse proxy | Caddy — automatic HTTPS |
  154. | Packaging | Windows installer, macOS packages, Linux DEB/RPM and Docker Compose |
  155. **Providers for v1:** Deepgram (STT) · one cloud LLM · ElevenLabs (TTS).
  156. Local models (Ollama, Whisper, Piper) follow in v1.1 — they need a GPU to hold a
  157. natural conversation, so they are not the default.
  158. **Latency target:** under 800 ms from the end of caller speech to the first audio out.
  159. Everything streams; the first sentence starts speaking while the rest is still being
  160. generated.
  161. ---
  162. ## Quick start
  163. ```bash
  164. git clone https://github.com/Dpro-at/Tel-Agent.git
  165. cd Tel-Agent
  166. cp .env.example .env
  167. # set ENCRYPTION_KEY in .env - generate one with: openssl rand -hex 32
  168. docker compose up -d --build
  169. ```
  170. Then open **http://localhost:38471**. The first visit creates the administrator —
  171. there are no default credentials. The API and its documentation are on
  172. http://localhost:38472/docs, and conversations live on the `tel-agent-data`
  173. volume (SQLite by default; a `postgres` profile is in `docker-compose.yml`).
  174. Every tagged release also publishes the images to GitHub Container Registry, so
  175. the build step can be skipped entirely:
  176. `docker compose -f docker-compose.release.yml up -d` — same layout, same
  177. volumes, interchangeable with the from-source file on one machine. If you would
  178. rather not run Docker at all, the [releases page](https://github.com/Dpro-at/Tel-Agent/releases/latest)
  179. has native installers for Windows, macOS and Linux.
  180. Both ports are published on **loopback only**. Reaching the installation from
  181. other machines is a decision made in `.env` — the `TEL_AGENT_*` block there
  182. lists the three values to change and why the dashboard image is rebuilt for it.
  183. On a server, put a reverse proxy terminating TLS in front instead.
  184. **Running it without Docker** stays supported and documented — contributors need
  185. to run the code without rebuilding an image on every edit. See
  186. [`CONTRIBUTING.md`](CONTRIBUTING.md) for the manual run, [`docs/SPEC.md`](docs/SPEC.md)
  187. for the full design and [`CLAUDE.md`](CLAUDE.md) for the development rules.
  188. ### Requirements for the phone channel
  189. - API keys for an STT, an LLM, and a TTS provider (or a GPU for local models)
  190. - A machine on the same LAN as the PBX
  191. - Network access to the PBX on 5060/UDP and an open RTP port range
  192. - A SIP endpoint. Most lines already are one:
  193. | Your line | What you need | Extra hardware |
  194. |---|---|---|
  195. | A PBX — 3CX, Asterisk, FreePBX | An extension on it | None |
  196. | A landline from an ISP | These are IP-based now. Either the provider gives you SIP credentials, or your router acts as a SIP registrar and you register against it — common with Fritz!Box in Austria and Germany | None |
  197. | A genuinely analog line — old copper, a fax line | An ATA to bridge it, e.g. a Grandstream HT801 | ~€30 |
  198. Tel-Agent only ever speaks SIP. That is deliberate: supporting telephony hardware
  199. directly is a project of its own, and an ATA solves it for about the price of a
  200. cable.
  201. ---
  202. ## Security notes
  203. - **The port is not exposed by default.** The server listens on `127.0.0.1`, and
  204. `python -m api` warns if you change that. The supported ways to reach an installation
  205. from elsewhere — a private network, a VPN, or a reverse proxy terminating TLS — all
  206. talk to a server on loopback, so none of them requires widening it.
  207. - **A password is required on first run.** There are no default credentials.
  208. - **API keys are encrypted at rest** and are never returned in full to the client.
  209. - **Recording announcements are on by default.** Austria requires both parties to be
  210. aware that a call is recorded, and the requirement still applies once a human takes
  211. over from the agent.
  212. ---
  213. ## Contributing
  214. **New here? [`docs/ONBOARDING.md`](docs/ONBOARDING.md) is the hour-long path from a fork
  215. to a merged pull request** — a translation, one file, no setup and no API keys. Thirty
  216. languages are sitting at 0% and any language you actually speak is welcome.
  217. Contributions are welcome. Check the open issues and the channel extension contract before starting a feature, and keep each pull request focused on one concern.
  218. **All contributors must sign the [CLA](CLA.md)** before their first pull request is
  219. merged. Read [`CONTRIBUTING.md`](CONTRIBUTING.md) before opening one. Everything in the
  220. repository — code, comments, commit messages, documentation — is written in English.
  221. <!-- Two marks, inked per theme. These are the agents the repo is configured for, not
  222. models Tel-Agent connects to — that row is at the top. docs/brand/agents/README.md -->
  223. <p>
  224. <picture>
  225. <source media="(prefers-color-scheme: dark)" srcset="docs/brand/agents/agents-dark.svg">
  226. <source media="(prefers-color-scheme: light)" srcset="docs/brand/agents/agents-light.svg">
  227. <img src="docs/brand/agents/agents-light.svg" alt="Built with Antigravity and Codex" height="24">
  228. </picture>
  229. </p>
  230. **Working with an AI coding agent?** Point it at [`AGENTS.md`](AGENTS.md) — Codex,
  231. Antigravity and the rest find it on their own. [`CLAUDE.md`](CLAUDE.md) is the full
  232. working contract; every other entry file in the repository is a pointer to those two, so
  233. the rules cannot drift apart.
  234. Found a security problem? **Do not open a public issue** — see
  235. [`SECURITY.md`](SECURITY.md).
  236. ---
  237. ## Star History
  238. <a href="https://www.star-history.com/?repos=dpro-at%2Ftel-agent&type=date&legend=top-left">
  239. <picture>
  240. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=dpro-at/tel-agent&type=date&theme=dark&legend=top-left" />
  241. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=dpro-at/tel-agent&type=date&legend=top-left" />
  242. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=dpro-at/tel-agent&type=date&legend=top-left" />
  243. </picture>
  244. </a>
  245. ---
  246. ## License
  247. [AGPL-3.0](LICENSE). Copyright © Dpro GmbH.
  248. If you run a modified version of Tel-Agent as a network service, you must publish your
  249. modifications. The free version is never crippled; it is the product.
  250. For a commercial license permitting closed-source integration, contact
  251. Dpro GmbH at [info@dpro.at](mailto:info@dpro.at).
  252. Dpro GmbH · Wipplingerstraße 20/18, 1010 Wien, Austria · FN 631492s, Handelsgericht Wien

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.