Skip to content

README.md

Latest commit

 

History

History
65 lines (45 loc) · 1.68 KB

README.md

File metadata and controls

65 lines (45 loc) · 1.68 KB

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.