Droidmind

🚀 DroidMind

DroidMind is a powerful tool that enables AI assistants to interact with Android devices via ADB (Android Debug Bridge). It offers secure interfaces for device operations, file management, screenshot capturing, log viewing, and more, while supporting a variety of ADB commands.

🚀 Quick Start

DroidMind is a remarkable tool that empowers AI assistants to interact seamlessly with Android devices through ADB. It offers a secure interface for a wide range of functions, including device operations, file management, screenshot capturing, and log viewing, all while supporting various ADB commands.

✨ Features

• Device Control: Supports advanced operations such as device restart and entering recovery mode.
• File Management: Enables file upload/download between the device and the computer, as well as directory creation/deletion.
• UI Interaction: Provides functions like simulating clicks, swipes, and text input for automated operations.
• Log Analysis: Facilitates viewing of device log information and error detection.
• Security: Incorporates a built - in command verification mechanism to prevent malicious operations and ensure safe usage.

📦 Installation

DroidMind uses UV as its dependency management tool. Please follow these steps to install:

# Initialize the project
uv init

# Install all dependencies
uv install

💻 Usage Examples

Basic Usage

Here are some example commands that an AI assistant can execute through DroidMind:

• "List all connected Android devices and their detailed information"
• "Check the battery status of my phone and report it to me"
• "Take a screenshot of my Pixel phone and show the current display content"
• "Check the remaining storage space of the device"
• "Show the recent ANR and crash logs"

🔧 Technical Details

DroidMind provides a comprehensive security protection mechanism to ensure device safety:

• Command Verification: All shell commands are checked against an allow - list.
• Risk Assessment: Commands are executed according to security levels (Safe, Low - Risk, Medium - Risk, High - Risk, Severe - Risk).
• Input Sanitization: Defends against command injection attacks.
• Protected Paths: System directories and critical paths are prohibited from being modified.
• Comprehensive Logging: All operations are logged for easy auditing.
• Anomaly Pattern Detection: Identifies and blocks potentially dangerous commands.

Development Process

DroidMind uses UV for dependency management and the development process. Please follow these steps for development:

# Update dependencies
uv sync

# Run tests
pytest

# Check code style
ruff check .

# Perform type checking
mypy .

🤝 How to Contribute

Contributions are welcome! Please follow these steps to submit a pull request:

1. Fork the project repository.
2. Create a feature branch (e.g., git checkout -b feature/amazing - feature).
3. Set up the development environment using UV.
4. Make modifications.
5. Run tests and code style checks.
6. Commit your changes (e.g., git commit -m 'Add amazing feature').
7. Push to the branch (e.g., git push origin feature/amazing - feature).
8. Create a pull request.

📄 License

This project is under the Apache License. Please refer to the LICENSE file for detailed information.

Developer: Stefanie Jane 🌠

If you find DroidMind useful, please support me by buying a Monster Ultra Violet ⚡️ on Ko - fi!