viajatech/agente-isabella

What it is

Isabella Llamadas is an Android app that places a call from your own SIM and converses in real time using Google Gemini Live's voice. Audio is injected digitally into the call through the phone's audio mixers, so Isabella does not rely on the speaker; this requires root with Magisk because Android blocks normal apps from writing audio into a call. A free Cloudflare Worker holds your Gemini API key and issues short-lived, single-use tokens to the phone.

It is aimed at people who want a self-hosted AI phone assistant on hardware they control, and who accept rooting the device. The repository ships the Android app, an optional Magisk privileged-app module, the token Worker, the Isabella persona file, and macOS build/install scripts. A no-call mode lets you talk to Isabella through the mic and speaker without root.

Quick start

The documented flow is designed around an AI coding agent (Claude Code, Codex, Gemini CLI, Copilot, Cursor) that walks you through the steps on a Mac:

1. Clone the repository and open your agent in that directory:

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

   Then ask it to read AGENTS.md and guide you through installing Isabella Llamadas on your phone. The agent handles the computer side; you handle what only a person can do (touching the phone, volume/power buttons, accepting wipes, entering passwords) and it pauses and waits at each of those moments.

2. Prepare the required accounts: an Google AI Studio API key (Gemini has a free tier with limits; some usage may be billed per pricing) and a free Cloudflare account. The key goes only into the Worker via npx wrangler secret put GEMINI_API_KEY_AQ; it should never be pasted into a chat, a git-tracked file, or an adb shell command.

3. Create your local config from the example (cp mi_config.env.example mi_config.env), then use ./configurar_app.sh to generate the device secret and ./compilar.sh to build the APK. The signing key is created under llaves/ on first build with its password stored in the macOS Keychain.

The result is an installed app that converses through the phone's mic and speaker; the integrated call mode requires the Magisk root step (which wipes the device) plus audio-mixer configuration. The full per-phase detail, including the root and first-call phases, lives in AGENTS.md.

Requirements and constraints

• Hardware: an Android 14+ phone you can root. The project was tested on a Samsung Galaxy A72 (Qualcomm); other phones may need mixer adaptation (see the architecture doc).
• Host: macOS (Apple Silicon or Intel) with Homebrew; the build scripts use aapt2, javac, d8, and apksigner rather than Gradle or Android Studio. A USB data cable is required.
• Root consequences: rooting and flashing can wipe all data or brick the device; the repo includes a boot recovery guide for its A72 experience.
• Accounts: bring your own Gemini key and Cloudflare account. The Worker enforces rate caps (3 per minute, 30 per day) and tokens are bound to the configured voice and persona.
• License: non-commercial use with mandatory attribution; misuse revokes the license. The responsible-use policy requires Isabella to always identify as an AI and to call only your own numbers or people who consented — no spam, fraud, impersonation, or unannounced recording.

Customization

Edit the "TU CONFIGURACIÓN" section of puente/lib/isabella.mjs to set who Isabella calls on behalf of, what she knows (your business or project), and the voice, then redeploy the Worker with cd token-worker && npm run genera-setup && npx wrangler deploy. The phone does not need to be touched, because the persona travels inside each token.

HotRepo's take

On the 2026-11-07 Java new-project list, the repository added 3 stars and 0 forks over a roughly one-hour window, reaching 105 stars overall. There is no all-language daily rank on record and no Hacker News discussion, so this is a snapshot of a small, young project rather than evidence of broader adoption. What stands out technically is the combination of constraints: no Gradle build, a Cloudflare Worker as a key-vault-and-token-mint layer, and root-level audio injection to make a real SIM call work without VoIP. That architecture also means the project's usefulness is narrow — it depends on a specific rooted phone, macOS tooling, and your own API keys.