Welcome to PhoneAgent! This guide will help you download and run the PhoneAgent Android app on your device. Follow these steps to start automating your daily tasks effortlessly.

1. Visit the Releases page to find the latest version of PhoneAgent.
2. Locate the most recent release. You will see a link to download an APK file.
3. Click on the APK link to start your download.
4. Once the download completes, go to your device's Downloads folder.
5. Tap on the downloaded APK file to begin installation.
6. If prompted, allow installation from unknown sources. This step is important since the app is not from the Play Store.
7. After installation, you can find PhoneAgent in your app drawer. Tap to open.

PhoneAgent offers numerous features to enhance your user experience:

• Multiple Service Providers: Supports services like Ollama, OpenAI, Anthropic (Claude), Google (Gemini), and Qwen (通义千问).
• Three Operating Modes:
  • Visual Mode: Uploads screenshots for AI analysis (requires screen recording permission).
  • Accessibility Mode: Uses accessibility services to extract structured content from the screen without screenshots.
  • Hybrid Mode: Combines visual and accessibility modes for comprehensive task execution.
• Accessibility Service Operations: Simulates user actions like clicks, inputs, and swipes.
• Intelligent Screen Analysis: Automatically captures or retrieves screen content and uses AI to analyze and execute tasks.
• Task Automation: Performs tasks based on AI analysis results.
• Comprehensive Action Support: Includes Launch, Tap, Type, Swipe, Long Press, Double Tap, Back, and Home operations.
• User Intervention Mechanism: Pauses automatically when manual input is required, such as for captchas or passwords.
• Voice Input Support: Allows voice commands for task descriptions (requires speech recognition support on your device).
• Background Execution: Supports foreground services for continuous task execution.
• Detailed Logging: Displays AI's thought process, action commands, and execution results.
• Context Management: Smartly compresses historical messages to prevent context overflow.

To run PhoneAgent smoothly, ensure your device meets the following requirements:

• Android Version: Android 8.0 (Oreo) or higher.
• RAM: Minimum 2 GB of RAM for optimal performance.
• Storage: At least 50 MB of available storage space for app files.
• Permissions: Access to accessibility services, screen recording, and microphone for full functionality.

After installation, follow these steps to use PhoneAgent:

1. Grant Permissions: When you open PhoneAgent for the first time, it will request various permissions. Accept these to enable full functionality.
2. Choose a Mode: Select your desired mode based on the task you wish to perform.
3. Input a Task: Use text or voice input to describe the task you want the AI to carry out.
4. Monitor Progress: Watch as PhoneAgent analyzes your screen and executes tasks intelligently.
5. Review Logs: Access logs to understand how tasks were processed and performed.

If you experience any issues, consider the following solutions:

• App Crashes: Make sure you have the most recent version of PhoneAgent. Reinstalling may help fix crashes.
• Permission Issues: Double-check that all required permissions are enabled in your device settings.
• AI Processing Delays: Ensure your internet connection is stable, as some AI features may require online access.

For further assistance, look for help on our GitHub Issues page. You can report bugs, request features, or ask questions there.

• Visit Documentation for detailed guides on using specific features.
• Join our community on Discord for discussions and support.

Thank you for choosing PhoneAgent! Enjoy smarter, more efficient mobile tasks.