viajatech/agente-isabella

项目介绍

Isabella Llamadas 是一款 Android 应用：它从你自己的 SIM 卡拨出电话，并与接听方用 Google Gemini Live 的语音实时对话。Isabella 的声音通过手机音频混音器以数字方式注入通话，不依赖扬声器外放；这需要 Magisk root，因为普通应用无法把音频写进通话。免费的 Cloudflare Worker 负责保存 Gemini API Key，并向手机签发一次性短期 token。

项目面向愿意 root 设备、想把 AI 电话助手跑在自己硬件上的用户。仓库包含 Android 应用、可选的 Magisk 特权应用模块、token Worker、Isabella 人设文件，以及 macOS 上的构建和安装脚本。另有不依赖 root 的无通话模式，可以只通过麦克风和扬声器与 Isabella 对话。

快速使用

README 设计的流程由 AI 编程代理（Claude Code、Codex、Gemini CLI、Copilot、Cursor 等）在 Mac 上带你逐步完成：

1. 克隆仓库并在该目录打开你的代理：

   git clone https://github.com/viajatech/agente-isabella.git
   cd agente-isabella
   

   然后让它读取 AGENTS.md，指引你把 Isabella Llamadas 装到手机上。代理负责电脑侧操作；手机侧只由人完成的事（触屏、按音量键和电源键、确认擦除、输入密码）由你来做，每到这些节点代理会停下来解释并等待。

2. 准备账号：一个 Google AI Studio API Key（Gemini 有带限额的免费层，部分用法可能收费，见定价）和一个免费的 Cloudflare 账号。Key 只通过 npx wrangler secret put GEMINI_API_KEY_AQ 放进 Worker，不要粘贴到聊天、会进 git 的文件或 adb shell 命令中。

3. 从示例生成本地配置（cp mi_config.env.example mi_config.env），再用 ./configurar_app.sh 生成设备密钥、用 ./compilar.sh 构建 APK。首次构建会在 llaves/ 下创建签名密钥，密码存入 macOS 钥匙串。

完成后会得到一个能通过手机麦克风和扬声器对话的应用；将声音注入真实通话需要 Magisk root 步骤（会清空设备数据）并配置音频混音器。每个阶段（包括 root 和第一次打电话）的细节都在 AGENTS.md 里。

使用约束

• 硬件： 需要一台能 root 的 Android 14+ 手机。项目在 Samsung Galaxy A72（高通平台）上测试过；其他机型可能需要适配混音器（见架构文档）。
• 主机： macOS（Apple Silicon 或 Intel）并安装 Homebrew；构建脚本使用 aapt2、javac、d8、apksigner，不用 Gradle 或 Android Studio。需要一根数据 USB 线。
• root 风险： root 和刷机可能清空全部数据或损坏设备；仓库附有基于 A72 经验的启动恢复指南。
• 账号： 自备 Gemini Key 和 Cloudflare 账号。Worker 限制频率（每分钟 3 次、每天 30 次），token 与配置的人设和声音绑定。
• 许可证： 仅限非商业使用且必须署名，滥用会撤销许可。负责任使用政策要求 Isabella 始终声明自己是 AI，只能拨打你自己的号码或已同意者的号码，禁止垃圾电话、欺诈、冒充和未经告知的录音。

自定义 Isabella

编辑 puente/lib/isabella.mjs 的「TU CONFIGURACIÓN」部分，设置 Isabella 以谁的名义打电话、知道什么（你的业务或项目）以及声音，然后用 cd token-worker && npm run genera-setup && npx wrangler deploy 重新部署 Worker。手机无需改动，因为人设随每个 token 下发。

HotRepo 点评

在 2026-11-07 的 Java 新项目榜记录中，该项目在约一小时的统计窗口内新增 3 个 Star、0 个 Fork，总 Star 达到 105。它没有全语言日榜名次记录，也没有 Hacker News 讨论，因此这只是一个规模小、时间新的项目的快照，不足说明更广泛的采用情况。技术上值得关注的是几种约束的组合：不用 Gradle 构建、用 Cloudflare Worker 作为密钥保管与 token 签发层、以及通过 root 级音频注入让真实 SIM 通话无需 VoIP 即可工作。这也意味着适用范围较窄：依赖特定可 root 机型、macOS 工具链和你自己的 API Key。