-
-
Notifications
You must be signed in to change notification settings - Fork 8
Quick Start.md
KNOOP edited this page Jan 9, 2026
·
1 revision
This guide helps you quickly install and configure Ava.
| Requirement | Description |
|---|---|
| Android Version | 7.0 (API 24) or higher |
| Architecture | arm64-v8a or armeabi-v7a |
| Home Assistant | Must be installed and running |
| ESPHome Integration | Must be installed in HA |
| Network | Device and HA must be on same LAN |
Download the latest version from GitHub Releases:
- Transfer APK file to your Android device
- Tap APK file to start installation
- If prompted about "Unknown sources", allow installation
On first launch, Ava will request these permissions:
| Permission | Purpose | Required |
|---|---|---|
| Microphone | Voice input | ✅ Yes |
| Overlay | Display screensaver, notifications, etc. | ✅ Yes |
| Foreground Service | Keep service running | ✅ Yes |
| Camera | Photos and video | ❌ Optional |
| Bluetooth | Presence detection | ❌ Optional |
| Location | Required for Bluetooth scanning | ❌ Optional |
- Open Home Assistant
- Go to Settings → Devices & Services → Integrations
- Click + Add Integration in bottom right
- Search for ESPHome
- Click to install
- Launch Ava app
- Go to Settings → Voice Satellite
- Tap Start Service
- Return to Home Assistant
- ESPHome integration will auto-discover Ava device
- Click Configure to complete setup
- In ESPHome integration, click Configure
- Enter Ava device's IP address
- Port defaults to 6053
- Click Submit
- Go to Settings → Voice Assistants
- Ensure voice assistant pipeline is configured
- Recommended setup:
- Speech-to-Text: Whisper
- Text-to-Speech: Piper
- Conversation Agent: Home Assistant built-in
- Go to Settings → Voice Satellite
- Confirm status shows "Connected"
- Select your preferred wake word
- Say wake word (default "Hey Jarvis")
- After hearing prompt sound, say "What time is it"
- Ava should reply with current time
- Say wake word
- Say "Turn on the living room light" (assuming you have this device)
- Light should turn on
- Ensure Ava and Home Assistant are on same network
- Check if firewall is blocking port 6053
- Try restarting Ava service
- Try manually adding device
- Check network stability
- Ensure Ava isn't being killed by system
- Disable battery optimization in settings
- Check Home Assistant voice assistant configuration
- Ensure Whisper and other components are running
- Check network latency
After setup is complete, you can:
Back to Home