Skip to content
Back to search

agentring

Let your AI agents call your phone over VoIP, and call them back. Your phone rings like a real call, even locked; a voice AI talks it through and returns the transcript. Self-hosted, open source, no phone numbers or Twilio.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mutonby/agentring with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mutonby/agentring'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mutonby--agentring/badge.svg)](/listings/mutonby--agentring)

HTML

<a href="/listings/mutonby--agentring"><img src="/api/listings/mutonby--agentring/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.

You need: - somewhere to run the relay: a Linux server with Docker and a domain name, **or** your own computer with Docker (the phone on the same Wi-Fi, or anywhere over Tailscale), - a free Firebase project, which is what makes a locked phone ring ([docs/firebase.md](docs/firebase.md)), - a key for the voice AI: Gemini ([free tier](https://aistudio.google.com/apikey)), or OpenAI, xAI (Grok) or Phonic ([providers](docs/voice.md#providers)), - an Android phone.

# 1. The relay, on a server with a domain (ports 80, 443, UDP 50000-50100 and TCP 7881 open)
cd deploy && cp .env.example .env && $EDITOR .env && docker compose up -d --build
#    ... or on your own computer, at its LAN or Tailscale IP
cd deploy && cp .env.local.example .env.local && $EDITOR .env.local \
  && docker compose -f docker-compose.local.yml --env-file .env.local up -d --build
docker compose logs relay | grep -A2 "API key"   # add the same -f/--env-file for the local one

# 2. The computer where your agent runs
uv tool install './daemon[voice]'
agentring init --relay https://relay.example.com --api-key ak_...
agentring pair                         # scan the QR code with the app
agentring msg "hello"                  # the phone gets a notification
echo GEMINI_API_KEY=... >> ~/.agentring/.env  # or OPENAI_API_KEY / XAI_API_KEY / PHONIC_API_KEY
agentring call "Testing agentring" --ai       # + --provider openai|grok|phonic

# 3. Your agent (Claude Code here; others: docs/agents.md)
claude mcp add agentring -- agentring mcp

Get the app on [Google Play](https://play.google.com/store/apps/details?id=dev.agentring.app), or the APK from [Releases](https://github.com/mutonby/agentring/releases). The full tutorial, step by step for both options and with a troubleshooting table: **[docs/setup.md](docs/setup.md)**. If the phone doesn't ring when locked, it's usually the vendor's battery saver: [docs/troubleshooting-oem.md](docs/troubleshooting-oem.md).

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 · 199 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. # agentring
  2. **Your AI agent can call you.** When it needs a decision, hits a wall or finishes a
  3. long job, your phone rings like a real call, even locked and in Doze. A voice AI tells
  4. you what's going on, you talk it through, and the agent gets the transcript and carries
  5. on. You can also call your agents back from the app and ask them things by voice.
  6. Open source, with no phone numbers, no Twilio and no per-minute telephony fees: calls go
  7. over VoIP straight to the app. Use the hosted version at [agentring.io](https://agentring.io),
  8. or run everything on your own server.
  9. [![Get it on Google Play](https://img.shields.io/badge/Google_Play-Get_the_app-1f1f1f?style=for-the-badge&logo=googleplay&logoColor=white)](https://play.google.com/store/apps/details?id=dev.agentring.app&referrer=utm_source%3Dgithub%26utm_medium%3Dreadme)
  10. [![Try it hosted, free](https://img.shields.io/badge/agentring.io-Try_it_hosted%2C_free-c2410c?style=for-the-badge)](https://agentring.io/login)
  11. [![GitHub stars](https://img.shields.io/github/stars/mutonby/agentring?style=flat&logo=github)](https://github.com/mutonby/agentring/stargazers)
  12. [![CI](https://github.com/mutonby/agentring/actions/workflows/ci.yml/badge.svg)](https://github.com/mutonby/agentring/actions/workflows/ci.yml)
  13. [![Android](https://github.com/mutonby/agentring/actions/workflows/android.yml/badge.svg)](https://github.com/mutonby/agentring/actions/workflows/android.yml)
  14. [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
  15. https://github.com/user-attachments/assets/4d925f22-727f-4d66-8665-c392cc3d1eb3
  16. *Sound on. A real run with Claude Code, a Pixel 6 and the voice AI: a migration fails, Claude Code
  17. calls the locked phone, you decide, it carries on. The phone is a screen recording with the call
  18. audio (the ringtone was added), the terminal is redrawn from Claude Code's output, and only the waits were cut. Silent
  19. version: [demo.gif](docs/media/demo.gif).*
  20. ## Try it in five minutes
  21. With the hosted version there is no server, Firebase project or voice AI key to set up.
  22. 1. **Install the app** from [Google Play](https://play.google.com/store/apps/details?id=dev.agentring.app&referrer=utm_source%3Dgithub%26utm_medium%3Dreadme) (Android 8 or newer).
  23. 2. **[Sign in at agentring.io](https://agentring.io/login)** with your email (free plan, no
  24. card) and scan the QR code on your dashboard with the app. The phone is paired.
  25. 3. **Add the MCP server to your agent.** The dashboard shows the command with your key:
  26. ```bash
  27. claude mcp add --transport http agentring https://agentring.io/mcp \
  28. --header "Authorization: Bearer ak_…"
  29. ```
  30. Then ask your agent: *"run the migration and call me if anything fails."*
  31. The free plan has 1 phone, 10 call minutes a month with the voice AI included, and 100
  32. messages a day. Other agents (Codex, opencode, OpenClaw, Hermes, n8n):
  33. [docs/agents.md](docs/agents.md#recipes-by-harness). To run it all yourself instead, see
  34. [Self-hosting](#self-hosting).
  35. ## What it does
  36. - **Your agent reaches you.** It can send you a message, wait for your reply or call
  37. you (`send_message`, `get_replies`, `call`). On a call, a voice AI explains why the
  38. agent is calling, answers your questions and hands the transcript back.
  39. - **You reach your agents.** Tap "Call agent" in the app. The voice AI can ask your own
  40. agents for help mid-call. If one is slow, the call goes on and its answer arrives
  41. when it's ready, or as a message if you've already hung up.
  42. - **Nothing gets lost.** A missed call turns into a message you can answer from the
  43. notification.
  44. Things people use it for: *"run the migration and call me if anything fails"*, *"ask
  45. me before you deploy"*, *"what did CI say?"* while driving, a daily call with your
  46. assistant about your inbox.
  47. ## Works with your agent
  48. agentring doesn't care which harness you use: anything that speaks MCP can reach you,
  49. and anything you can run as a command can be consulted from a call.
  50. | | Reaches you | You consult it from a call |
  51. |---|---|---|
  52. | Claude Code | MCP | `claude -p` |
  53. | Codex | MCP | `codex exec` |
  54. | opencode | MCP | `opencode run` |
  55. | Grok Build | MCP, or the [plugin](plugins/agentring) | |
  56. | OpenClaw | MCP | `openclaw agent` |
  57. | Hermes | MCP | `hermes -z` |
  58. | n8n, scripts, anything with HTTP | REST API, CLI | any command, or a small script for an HTTP agent |
  59. Copy-paste setup for each: [docs/agents.md](docs/agents.md#recipes-by-harness). OpenClaw and
  60. Hermes have one command for all of it: `agentring connect openclaw` / `agentring connect hermes`,
  61. or install the [skill](skills/agentring) and ask your agent to set agentring up.
  62. The skill installs in any harness that reads skills with `npx skills add mutonby/agentring`
  63. ([skills.sh](https://skills.sh/mutonby/agentring)), and from ClawHub as `@mutonby/agentring`.
  64. ## Self-hosting
  65. Everything on your own machines, free and without limits. You need:
  66. - somewhere to run the relay: a Linux server with Docker and a domain name, **or** your own
  67. computer with Docker (the phone on the same Wi-Fi, or anywhere over Tailscale),
  68. - a free Firebase project, which is what makes a locked phone ring ([docs/firebase.md](docs/firebase.md)),
  69. - a key for the voice AI: Gemini ([free tier](https://aistudio.google.com/apikey)), or OpenAI,
  70. xAI (Grok), Phonic or OpenRouter ([providers](docs/voice.md#providers)),
  71. - an Android phone.
  72. ```bash
  73. # 1. The relay, on a server with a domain (ports 80, 443, UDP 50000-50100 and TCP 7881 open)
  74. cd deploy && cp .env.example .env && $EDITOR .env && docker compose up -d --build
  75. # ... or on your own computer, at its LAN or Tailscale IP
  76. cd deploy && cp .env.local.example .env.local && $EDITOR .env.local \
  77. && docker compose -f docker-compose.local.yml --env-file .env.local up -d --build
  78. docker compose logs relay | grep -A2 "API key" # add the same -f/--env-file for the local one
  79. # 2. The computer where your agent runs
  80. uv tool install './daemon[voice]'
  81. agentring init --relay https://relay.example.com --api-key ak_...
  82. agentring pair # scan the QR code with the app
  83. agentring msg "hello" # the phone gets a notification
  84. echo GEMINI_API_KEY=... >> ~/.agentring/.env # or OPENAI_API_KEY / XAI_API_KEY / PHONIC_API_KEY
  85. agentring call "Testing agentring" --ai # + --provider openai|grok|phonic
  86. # 3. Your agent (Claude Code here; others: docs/agents.md)
  87. claude mcp add agentring -- agentring mcp
  88. ```
  89. Install the app from **[Google Play](https://play.google.com/store/apps/details?id=dev.agentring.app&referrer=utm_source%3Dgithub%26utm_medium%3Dreadme)**
  90. (recommended: it updates itself, and the same app works with agentring cloud and with your
  91. own relay). The APK on [Releases](https://github.com/mutonby/agentring/releases) is for
  92. those who'd rather not use Play; it's signed with a different key, so uninstall one before
  93. installing the other. The full
  94. tutorial, step by step for both options and with a troubleshooting table:
  95. **[docs/setup.md](docs/setup.md)**. If the phone doesn't ring when locked, it's usually the
  96. vendor's battery saver: [docs/troubleshooting-oem.md](docs/troubleshooting-oem.md).
  97. ## How it works
  98. ```
  99. your agent ──MCP/CLI──▶ daemon ──WSS (outbound only)──▶ relay ──FCM push──▶ Android app
  100. ▲ │ (your server) │
  101. └── agents.yaml ◀── voice AI (realtime) ◀──────── LiveKit (call audio) ───────┘
  102. ```
  103. - **relay** (TypeScript): pairing, messages, call state, push, LiveKit tokens. Runs on
  104. your server behind Caddy.
  105. - **LiveKit**: the call audio, self-hosted in the same compose file.
  106. - **daemon** (Python): the `agentring` CLI, the MCP server and the voice AI. Runs next
  107. to your agents, behind NAT is fine.
  108. - **Android app** (Kotlin): QR pairing, the native call screen, messages.
  109. The voice AI is the voice, your agent is the brain: a realtime speech model handles
  110. the conversation and hands real work to your agents. Pick the one you like:
  111. | Voice AI | `--provider` | Key |
  112. |---|---|---|
  113. | [Gemini Live](https://ai.google.dev/gemini-api/docs/live) (default, free tier) | `gemini` | `GEMINI_API_KEY` |
  114. | [OpenAI Realtime](https://developers.openai.com/api/docs/guides/realtime-conversations) | `openai` | `OPENAI_API_KEY` |
  115. | [Grok Voice](https://docs.x.ai/docs/guides/voice/agent) (xAI) | `grok` | `XAI_API_KEY` |
  116. | [Phonic](https://docs.phonic.ai) | `phonic` | `PHONIC_API_KEY` |
  117. | [OpenRouter](https://openrouter.ai): speech-to-text, any chat model, text-to-speech, experimental ([details](docs/voice.md#openrouter-speech-to-text--any-model--text-to-speech)) | `openrouter` | `OPENROUTER_API_KEY` |
  118. | Your own server, e.g. [HF speech-to-speech](https://github.com/huggingface/speech-to-speech) + a small model on llama.cpp (experimental) | `local` | none |
  119. Set `AGENTRING_VOICE_PROVIDER` in `~/.agentring/.env` to use one for every call, from the
  120. CLI and from MCP. How they compare (latency, tool use), how to measure them yourself
  121. (`agentring voice bench`), the local setup and how to add another one:
  122. [docs/voice.md](docs/voice.md#providers).
  123. More: [architecture](docs/architecture.md) · [protocol](docs/protocol.md) ·
  124. [voice AI](docs/voice.md)
  125. ## Privacy and security
  126. Self-hosted, everything runs on your own servers and accounts (for the hosted version,
  127. see its [privacy policy](https://agentring.io/privacy)). Messages and call metadata are stored
  128. on your relay. Push notifications go through your own Firebase project; they are
  129. signed, not encrypted, so Google's FCM can read pushed text. Call audio goes through
  130. your LiveKit server and, with the voice AI, to the provider you chose (Google, OpenAI,
  131. xAI or Phonic); on Google's free tier, Google may use that data to improve its products.
  132. Over the phone, the voice AI acts on what it hears, so give it only the tools and
  133. agents you'd trust someone holding your phone with. Details and the threat model:
  134. [SECURITY.md](SECURITY.md).
  135. ## Limitations
  136. - Android only (no iOS yet). Android Auto is in beta and only in the APK from Releases:
  137. Google Play doesn't allow calling apps for cars in production yet
  138. ([docs/android-auto.md](docs/android-auto.md)).
  139. - It's a young project. The app is on Google Play, and we test it most on a Pixel 6
  140. (Android 16); other vendors' battery savers can hold a call back
  141. ([docs/troubleshooting-oem.md](docs/troubleshooting-oem.md)). If it misbehaves on your
  142. phone, please open an issue.
  143. - Self-hosted, one user per relay: no accounts.
  144. - The voice AI works best with a cloud realtime model (Gemini, OpenAI, Grok or Phonic). A local
  145. one runs on your own machine (`--provider local`), but it's experimental and slower; others
  146. plug in through [`RealtimeBackend`](docs/voice.md#backends).
  147. ## Development
  148. ```bash
  149. cd relay && npm ci && npm test # relay
  150. cd daemon && uv run --extra voice pytest # daemon (+ e2e against the relay build)
  151. cd app-android && ./gradlew :core:test :app:assembleDebug
  152. ```
  153. CI builds the APK and runs an end-to-end test on an Android emulator against a real
  154. relay. See [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/release.md](docs/release.md).
  155. ## License
  156. [Apache-2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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