Airo

The open-source super app — AI chat, personal finance, TV & music, games, and reading in one local-first Flutter codebase.

🌐 developerscoffee.github.io/airo — live showcase, guides, and roadmap

Download · Modules · Quick Start · Contributing · Docs

---

Airo is the home. A modular super app built with Flutter — Airo TV is its first focused product, available now. Every module is local-first: your data, playlists, and conversations stay on your device by default. On-device AI drives the experience — model routing, offline fallback, and privacy-forward interactions in a real shipping app, not a demo.

Modules

Module	What it does	Status
📺 Airo TV	Bring-your-own-playlist IPTV player for Android TV	Available — v0.0.6
⭐ Airo TV Pro	Import intelligence, resilient playback, guide intelligence	In testing
🤖 Airo AI	On-device AI chat (Gemini Nano), model management, agent skills	In development
💰 AiroMoney	Personal finance tracking and money workflows	In development
🪙 Airo Coins	Standalone money home and secure vault	Available — v0.0.6 (preview; see #1240)
🎵 Airo Music	Music playback surfaces	In development
♟️ Airo Games	Chess and casual games (Stockfish engine)	In development
📖 Airo Reader	Reading surfaces with OCR	In development

All modules live in one monorepo with strict package boundaries — see the Repository Map.

📺 Airo TV — Available Now

See it in action

macOS (desktop)	Pixel 9 (mobile)

Touch playlist management — Under qualification

Physical Pixel 9 evidence confirms the add, persist, and remove journey for multiple authorized playlist sources on current mainline builds. This remains under qualification and is not included in the latest published preview. The image uses public IPTV.org examples and owned Airo artwork; it contains no private provider data or bundled content.

View the product story · Download the 1080×1920 store PNG

Airo TV is the focused Android TV build of Airo's media module (io.airo.app.tv). TV-first channel grid, search, and playback for your own M3U/M3U8 playlists.

• Bring your own playlist — Airo TV ships no IPTV content and no bundled channels.
• Google Cast support — requires _googlecast._tcp discovery and port 8009 on the local network.
• Verifiable releases — APK, Play Store AAB, macOS preview, and SHA256 checksums on every release.
• Honest device support — Android TV available, Fire TV experimental, mobile partial, macOS preview, iPad verified; see device paths.
• Documented — architecture, threat model, release docs.

Download

Current release: v0.0.6 — one release carrying every product line.

Product	Package	Download
📺 Airo TV (Android TV / Fire TV)	io.airo.app.tv	Airo-TV-0.0.6.apk · arm64-v8a · armeabi-v7a · x86_64
🤖 Airo (phone / tablet)	io.airo.app	Airo-0.0.6-10-arm64.apk
🪙 Airo Coins	io.airo.app.coins	AiroCoins-0.0.6-10-arm64.apk
🖥️ Airo TV for macOS	—	DMG · ZIP
📦 All releases	—	Releases

Not published: iOS/iPadOS (no Apple developer account) and web (CI validation only). Play Store AABs are attached to the release for store submission but no build is on Google Play yet.

Android builds are signed with a stable dogfood keystore. They upgrade cleanly over other dogfood-signed Airo builds but not over a future production-signed release — that transition will need an uninstall.

Before installing a direct-download APK, verify it against SHA256SUMS.

macOS builds are unsigned and not notarized; Gatekeeper will require an explicit override.

Why Trust Airo?

• Open-source codebase with public issue tracking and a transparent roadmap.
• Local-first: playlists and data stay on the device unless you load a remote URL directly.
• No bundled IPTV channels or copyrighted content.
• SHA256 checksums published for every release APK and AAB.
• Public security policy, privacy policy, threat model, and trust report.
• No hidden subscriptions and no mandatory accounts for the Airo TV player flow.

Quick Start

git clone git@github.com:DevelopersCoffee/airo.git
cd airo
make setup        # or: make setup-android / setup-ios / setup-web

Run the app:

make run-android  # or: run-ios / run-web / run-chrome

Verify changes:

make format && make analyze && make test

run-android, run-ios, and run-firetv target connected physical devices. Run make local-test-plan for the device workflow and make help for the full command list. For the Airo TV Edge Intelligence runtime (Rust FFI, media packs), see docs/features.

Platform Support

• Android: API 26+ (Android 8.0), compiled and targeting API 36 · iOS: 12.0+ · Web: modern browsers (Chrome preferred for development).

Android release builds require private signing material. Never commit app/android/key.properties, keystores, tokens, API keys, or local credentials.

Repository Map

.
├── app/                  # Flutter host application
├── packages/
│   ├── airo/             # AI-oriented package surface
│   ├── feature_coin/     # Personal finance package surface
│   ├── core_ai/          # AI contracts, registries, skills, model metadata
│   ├── core_auth/        # Authentication package
│   ├── core_data/        # Data and networking utilities
│   ├── core_domain/      # Domain primitives
│   └── core_ui/          # Shared UI package
├── docs/                 # Architecture, agent policy, wiki source, runbooks
├── e2e/                  # End-to-end assets and checks
├── scripts/              # Local automation
└── .github/              # CI, issue templates, PR template

Contributing

Airo is an open-source playground for developers who care about on-device AI, agent-driven engineering, and cross-platform Flutter architecture. Star the repo to follow the work; fork it to experiment or send a PR.

💬 Join the DevelopersCoffee Discord — share ideas, ask questions, and grow the community with us.

Good entry points:

• Docs fixes, onboarding polish, and troubleshooting guides.
• Host-only tests, bug reproduction, and accessibility improvements.
• good first issue · help wanted

Workflow:

1. Read CONTRIBUTING.md.
2. Pick or create a GitHub issue.
3. Follow the agent gate and Feature Packet flow in docs/agents/AGENT_POLICY.md.
4. Branch from origin/main, keep the PR scoped, run the relevant checks.

Documentation

• Architecture · Features · Security · Release · Troubleshooting · Wiki source
• Release engineering: V2 orchestrator · release workflow · publishing human setup · release checklist · repository health

Community Standards

Contributing · Code of Conduct · Security Policy · Trust · Privacy · Roadmap · Changelog · Download Verification

License

Airo is licensed under the MIT License.

Release profiles include third-party dependencies with their own licenses. See Third-Party Notices and the License Review before public redistribution.