Skip to content

Repository files navigation

AI Launcher for Android

An open-source AI-powered Android home screen launcher with voice control, smart app access, customizable wallpapers, and optional local LLM support.

AI Launcher Android Kotlin License

Redefine your desktop experience with AI

English | δΈ­ζ–‡ | ζ—₯本θͺž


🌟 Introduction

AI Launcher is an LLM-powered Android home screen launcher that lets users control their phone and launch applications through natural language and voice commands.

✨ Core Philosophy

  • 🎯 Voice First - Control your phone with natural language, hands-free
  • πŸš€ Quick Launch - Intelligently learns your habits, one-tap access to frequently used apps
  • 🎨 Personalization - Rich themes, wallpapers, and layout customization options
  • πŸ”’ Privacy Protection - All data stored locally, never uploaded to the cloud

πŸ“Ί Demo

AI Launcher Demo

πŸ“± Main Features

🎀 Voice Control

  • Supports Chinese and English voice recognition
  • Natural language understanding, control your phone like chatting
  • Launch apps, send messages, set alarms with voice
  • Offline voice recognition (requires local model download)

πŸ“² Smart App Management

  • Automatically learns frequently used apps, displayed at the top
  • Shows up to 8 frequently used apps (2 rows Γ— 4 columns)
  • Quick search and launch any app
  • App usage statistics and sorting

🎨 Personalization

  • Tech Background - Default sci-fi style grid background (can be disabled)
  • Image Wallpaper - Choose images from gallery as wallpaper
  • Gradient Background - 16 preset gradients + custom colors
  • Solid Color - Clean single-color background
  • Dark Mode - Auto-follow system or manual toggle

βš™οΈ Flexible Configuration

  • Supports multiple AI model backends:
    • Cloud models (OpenAI, Qwen, DeepSeek, etc.)
    • Local models (MLC LLM, completely offline)
  • Custom API endpoints and keys
  • Detailed permission management
  • Rich developer options

πŸ› οΈ Tech Stack

Core Technologies

  • Kotlin - Primary development language
  • Jetpack Compose - Modern UI framework
  • Material 3 - Latest Material Design specification
  • Coroutines - Asynchronous programming
  • ViewModel - Lifecycle-aware

Architecture

  • MVVM Pattern - Clear separation of concerns
  • Clean Architecture - Layered architecture design
  • Repository Pattern - Data access abstraction

Dependencies

  • Retrofit + OkHttp - Network requests
  • Gson - JSON parsing
  • Coil - Image loading
  • MLC LLM - Local large language model inference

πŸ“₯ Download & Install

Method 1: Download from Releases

Go to Releases Page to download the latest APK

Method 2: Build from Source

# Clone the repository
git clone https://github.com/IceAmber/ai-launcher.git
cd ai-launcher

# Build debug version
./gradlew assembleDebug

# Build release version
./gradlew assembleRelease

# APK located at app/build/outputs/apk/

Method 3: App Store

Coming soon to Google Play and other app stores, stay tuned!


πŸš€ Quick Start

1. First Launch

  • Grant necessary permissions (app list, voice recognition, etc.)
  • Choose whether to use tech background (enabled by default)
  • Configure AI model (optional)

2. Configure AI Model

Using Cloud Model (Recommended for beginners)

  1. Open Settings β†’ Model Configuration
  2. Select "Cloud Model"
  3. Enter API endpoint and key
    • Supports OpenAI, Qwen, DeepSeek compatible APIs
    • Example: https://api.openai.com/v1

Using Local Model (Completely Offline)

  1. Open Settings β†’ Model Configuration
  2. Select "Local Model (MLC)"
  3. Download model files (required for first use)
  4. Wait for download to complete

3. Use Voice Control

  • Tap the microphone icon or say wake word
  • Speak commands, for example:
    • "Open WeChat"
    • "Call Mom"
    • "Set alarm for 7 AM tomorrow"
    • "What's the weather today"

βš™οΈ Configuration

Model Configuration

Cloud Model Parameters

// Supported API formats
Base URL: https://api.openai.com/v1
API Key: sk-xxx
Model: gpt-3.5-turbo / gpt-4

// Qwen
Base URL: https://dashscope.aliyuncs.com/api/v1
API Key: sk-xxx
Model: qwen-turbo / qwen-plus

// DeepSeek
Base URL: https://api.deepseek.com/v1
API Key: sk-xxx
Model: deepseek-chat

Local Model

  • Default model: gemma-2-2b-it
  • Model size: ~1.5GB
  • Requires Android 5.0+ and 4GB+ RAM
  • Completely offline, no network required

Wallpaper Configuration

Tech Background

  • Deep blue background (#0A0E27)
  • Grid lines (40dp spacing)
  • 7 glowing nodes + connection lines
  • Customizable colors and transparency

Image Wallpaper

  • Select from gallery
  • Adjustable blur level
  • Add overlay for better readability
  • Custom overlay color and transparency

Gradient Background

  • 16 preset gradients (Sunset, Ocean, Forest, etc.)
  • Custom start and end colors
  • Real-time preview

🧩 Permissions

Permission Purpose Required
QUERY_ALL_PACKAGES Get app list for display and launch βœ… Required
RECORD_AUDIO Voice recognition β­• Optional
INTERNET Access cloud AI model API β­• Optional (not needed for local model)
VIBRATE Haptic feedback β­• Optional

🀝 Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.


πŸ”’ Privacy Policy

We value your privacy:

  • βœ… Local Storage - All data saved on device
  • βœ… No Data Collection - No personal information collected
  • βœ… No Cloud Upload - Voice recognition done locally (when using local model)
  • βœ… Open Source Transparency - Code fully open source, auditable

For detailed privacy policy, see PRIVACY.md


πŸ“„ License

Licensed under the Apache License 2.0.


πŸ™ Acknowledgments

Thanks to these open source projects:


πŸ“ž Contact


⭐ Star History

Star History Chart


If this project helps you, please give it a ⭐ Star!

Made with ❀️ by AI Launcher Team

About

An open-source LLM-powered Android launcher for controlling apps and phone actions through natural language and voice.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages