Smartphones have had voice assistants for years, but most of them only give text answers or basic web searches. If you have ever wanted an AI that actually takes control of your phone and executes tasks for you, a new tool changes the game.
This blog post provides a complete, easy-to-understand guide on Gotcha, the world’s first fully on-device open-source AI copilot for Android. You will learn what the application is, its core features, system requirements, how to download and install it, usage steps, credits, troubleshooting tips, and answers to frequent questions.
Table of Contents
What is Gotcha?
Gotcha is an open-source AI copilot designed specifically for Android devices. Unlike standard voice assistants that merely answer questions, Gotcha works alongside you to handle real device actions using natural language. It operates entirely on your phone without requiring a computer, server, or USB tethering. By combining a large language model with your live device context, it can interpret your requests and choose from over 100 native tools to perform tasks like sending messages, managing files, adjusting settings, and navigating apps.
Features of Gotcha
- Native Tool Catalog: Includes over 100 built-in tools to control phone calls, text messages, contacts, calendar entries, alarms, file management, terminal commands, location services, and app operations.
- Dual Copilot Modes: Features a Monitor mode for read-only inspection and safe planning, alongside an Operator mode that unlocks full execution control. You can switch between modes at any time.
- Assistive Ball: A floating bubble interface that stays on top of any app, offering quick push-to-talk voice calls and smart context actions.
- Screen Lens: Built-in optical character recognition that lets you circle anything on your screen to copy text, translate languages, or extract useful data.
- Strong Privacy Protection: Designed with zero built-in analytics or tracking telemetry. Your API keys are encrypted locally on your device storage and never synced externally.
- Flexible Model Support: Compatible with any OpenAI-compliant chat endpoint with function-calling capabilities, local servers, or direct sign-in options.
Requirement
To run Gotcha smoothly on your device, ensure you meet the following prerequisites:
- An Android smartphone running Android 11 or a newer version.
- An active API key from a supported provider (such as OpenAI, OpenRouter, Groq) or a local model server running via tools like Ollama or LM Studio, alternatively using the Samosa AI provider option.
- Sufficient storage space to download and install the application package.
- Necessary device permissions granted during setup for accessibility and system control.
Download
The application can be acquired directly from its official public release distribution channel. Users looking for a ready-to-use application file can download the latest installable package directly from the project release archives. Alternatively, developers wishing to compile the source code can clone the repository and build the application package locally using standard build tools.
Install
Follow these straightforward steps to get the application running on your Android device:
- Download the installation package file to your phone storage.
- Enable installation from unknown sources in your device settings if prompted.
- Open the downloaded package file and tap install.
- Launch the application from your app drawer. The app will open directly on the settings page where you can configure your API credentials and base URL.
- Grant the requested system permissions when prompted to enable full functionality.
How to use
Using Gotcha is straightforward once configured:
- Open the application and input your API key, model name, and appropriate base URL if using a custom endpoint.
- Choose your operating mode between Monitor mode for safe exploration and Operator mode for automated actions.
- Use the chat interface to type your request or tap the floating Assistive Ball to give voice commands naturally.
- Review the plan generated by the AI copilot and confirm execution for any sensitive actions before completion.
Credit
Gotcha is developed and maintained by the Samosa AI team along with open-source contributors from the developer community. The project is distributed under the open-source AGPL-3.0 license, promoting transparency and community collaboration in mobile AI automation.
Troubleshoot
If you encounter issues while using the application, review these common fixes:
- Model Errors or Failures: Ensure your API base URL includes the correct endpoint suffix and that your chosen model supports proper function calling.
- Permission Issues: Verify that accessibility and display-over-other-apps permissions are fully enabled in your Android system settings.
- Unexpected Actions: If the copilot misinterprets tasks due to non-deterministic screen elements, switch back to Monitor mode to inspect actions safely before executing them.
FAQs
- Is my personal data sent to external servers? No. Gotcha processes data locally on your device, and API keys are stored in encrypted local preferences.
- Do I need a computer to set it up? No PC, server, or ADB tethering is required. Everything runs as a self-contained app on your phone.
- Can I use local models? Yes, you can connect Gotcha to local server setups such as Ollama or LM Studio as long as they provide compatible chat endpoints.
- Is the app free to use? Yes, the core application is completely free and open-source.
Conclusion
Gotcha represents a major leap forward for mobile AI by shifting from passive text chat to active device assistance. Its combination of on-device privacy, extensive tool support, and dual safety modes makes it a powerful option for anyone looking to automate their Android workflow. If you found this guide helpful or have any questions about setting up your own AI copilot, please leave a comment below.
