oxnw/ai-phone

选用指南

AI 根据 README 整理 · 2026/10/28 13:16:45

使用方式

通过命令行使用，安装后运行 `uv run ai-phone setup` 配置，然后 `uv run ai-phone run` 启动守护进程，使用 `uv run ai-phone call` 拨打电话。

查看 README 依据

git clone https://github.com/oxnw/ai-phone.git cd ai-phone ./scripts/install.sh uv run ai-phone setup ``` Setup lets you choose incoming calls, outgoing calls, or both, then configures the model, line and voice. It recommends a local model based on detected RAM and downloads the required weights. Use `uv run ai-phone setup --plain` for plain prompts. The current speech backends use MLX on Apple Silicon, even when a cloud model handles the conversation. Supporting Linux or Windows would require different speech backends and changes to installation and platform

integration. The platform requirement applies to the computer running ai-phone; callers can use any phone or SIP client. ### Usage Start the daemon after setup: ```bash uv run ai-phone run ``` Keep it running while you want to receive calls. For outgoing calls only, start it when needed and stop it with Ctrl-C afterward. Setup does not install a background service. From another terminal in the repo, give the phone agent instructions for a call: ```bash uv run ai-phone call +15555550100 --json \ --prompt "Ask whether they have a table for two at eight tonight." ```

部署要求

需要 Apple Silicon 的 macOS，Intel Mac、Linux 和 Windows 不支持；内存推荐 16GB（默认4B模型）或32GB（9B模型），8GB系统可用2B模型；依赖 Git、Homebrew 和 uv；需要 SIP 地址或 SIP trunk、Telnyx、Twilio 账户用于电话连接。

查看 README 依据

<h1 align="center">ai-phone</h1> <p align="center">An AI phone agent that runs on your computer.</p> <p align="center"> <a href="docs/usage.md">Documentation</a> · <a href="architecture-essentials.md">Architecture</a> · <a href="LICENSE">AGPL-3.0</a> </p>  ### Installation | Requirement | Details | |---|---| | Platform | macOS on Apple Silicon. Intel Macs, Linux and Windows are not currently supported. |

| Memory | 16 GB recommended for the default 4B model; 32 GB for 9B. Setup also offers a smaller 2B model for 8 GB systems. | | Dependencies | Git, [Homebrew](https://brew.sh) and [uv](https://docs.astral.sh/uv/). The installer handles Python packages and the native SIP library. | | Storage | Several GB for model downloads, depending on the models selected. Setup checks available disk space. | | Phone connection | A SIP address for direct calls, or your own SIP trunk, Telnyx or Twilio account for telephone numbers. Carrier charges apply. | ```bash

已知限制

目前仅支持英语，且同时只能处理一个通话；平台要求仅适用于运行 ai-phone 的计算机，呼叫方可使用任何电话或 SIP 客户端。

查看 README 依据

Replace the example number with the number you want to call. The command returns the transcript when the call ends. Every outgoing call starts with an AI disclosure. Incoming calls use the greeting and instructions you set during setup. English and one call at a time are currently supported. For a free local test, enable incoming calls, select **A SIP address** in setup, and keep the name `agent`: ```bash pjsua --local-port 5070 sip:agent@127.0.0.1 ``` Run setup again to change the voice, model, call directions or caller ID, then restart the daemon. ### Agent integration

integration. The platform requirement applies to the computer running ai-phone; callers can use any phone or SIP client. ### Usage Start the daemon after setup: ```bash uv run ai-phone run ``` Keep it running while you want to receive calls. For outgoing calls only, start it when needed and stop it with Ctrl-C afterward. Setup does not install a background service. From another terminal in the repo, give the phone agent instructions for a call: ```bash uv run ai-phone call +15555550100 --json \ --prompt "Ask whether they have a table for two at eight tonight." ```