Metadata-Version: 2.5
Name: agentring
Version: 0.2.0
Summary: Let any AI agent call your phone over VoIP and message you (daemon + CLI)
Project-URL: Homepage, https://github.com/mutonby/agentring
Project-URL: Documentation, https://github.com/mutonby/agentring/tree/HEAD/docs
Project-URL: Issues, https://github.com/mutonby/agentring/issues
Project-URL: Source, https://github.com/mutonby/agentring
Author: agentring contributors
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai-agent,android,livekit,mcp,notifications,voip
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Communications :: Telephony
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28
Requires-Dist: python-dotenv>=1.0
Requires-Dist: pyyaml>=6
Requires-Dist: segno>=1.6
Requires-Dist: typer>=0.15
Requires-Dist: websockets>=14
Provides-Extra: voice
Requires-Dist: livekit<1.2,>=1.1.20; extra == 'voice'
Description-Content-Type: text/markdown

# agentring daemon

The agent side of [agentring](https://github.com/mutonby/agentring): the `agentring`
CLI, the MCP server (`agentring mcp`) and the voice AI for calls. It lets your AI
agents message and call your phone, and lets you call them back.

```bash
uv tool install 'agentring[voice] @ git+https://github.com/mutonby/agentring#subdirectory=daemon'   # or, from a checkout: uv tool install './daemon[voice]'
agentring init --relay https://relay.example.com --api-key ak_...
agentring pair                       # scan the QR with the Android app
agentring msg "hola"
agentring call "Testing agentring" --ai   # needs GEMINI_API_KEY in ~/.agentring/.env
claude mcp add agentring -- agentring mcp
```

Your API key must not cross the internet in clear, so a plain `http://` relay is refused
unless its host is loopback, a private or CGNAT (Tailscale) address, a `.local` name or a
single-label name such as `relay` in Docker. `AGENTRING_ALLOW_INSECURE_RELAY=1` lifts this,
for a network you trust that doesn't look like one. The local database is readable by you only.

You need your own relay (self-hosted, Docker compose) and the Android app. See the
[setup guide](https://github.com/mutonby/agentring/blob/main/docs/setup.md)
and [connecting agents](https://github.com/mutonby/agentring/blob/main/docs/agents.md).
