Android Agent

Android automation experiment focused on device control, cloud LLM orchestration, and an optional outbound-calls companion service.

Project Status

This repository is being shared as a portfolio project covering Android automation, device control, cloud LLM orchestration, and voice-related integration work. It is still experimental in places, but the codebase captures the structure and implementation approach of the project rather than serving as a polished end-user product.

Main Pieces

• app/: Android application
• agent-core/: shared Kotlin logic
• outbound-calls-service/: Python/Twilio/OpenAI companion backend
• docs/, reports/, archive/: supporting notes and historical context

Local Run

Android App

Requirements:

• Android Studio
• JDK 17
• Android SDK / build tools for the configured Gradle project

Commands:

./gradlew assembleDebug
./gradlew test

On Windows:

.\gradlew.bat assembleDebug
.\gradlew.bat test

The more realistic path for this repo is opening it in Android Studio and letting Gradle sync there.

Outbound Calls Service

Requirements:

• Python 3.9+
• pip
• Twilio account and phone number
• OpenAI API key with realtime access
• ngrok or equivalent local tunnel for webhook testing

Commands:

cd outbound-calls-service/backend
python -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python main.py

See outbound-calls-service/README.md for the deeper backend setup notes.

Notes

• Local properties and API credentials are not bundled.
• The Android app and the outbound-calls backend should be treated as separate experiments that happened to live in one repo.