aidlearning/AidLearning-FrameWork
aidlearning/AidLearning-FrameWork has 5,820 GitHub stars and 720 forks. GitHot measured -1 stars in 24 hours and +1 in 7 days. Last checked 2026-11-05 07:08 UTC. Last push 2026-04-02.
🔥🔥🔥AidLearning is a powerful AIOT development platform, AidLearning builds a linux env supporting GUI, deep learning and visual IDE on Android...Now Aid supports CPU+GPU+NPU for inference with high performance acceleration...Linux on Android or HarmonyOS
Measured star growth
- in 24h
- -1
- in 7 days
- +1
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README-en.md
Original🚀 AidLux - The AI/LLM Swiss Army Knife for your phone [中文版]
AidLux: The AI Swiss Army Knife for your phone. Run native Ubuntu and deploy LLMs, VLMs, VLAs, and OpenClaw locally—all in one device.
AidLux is a one-stop AIoT application development and deployment platform based on the ARM architecture, bridging the Android/HarmonyOS and Linux ecosystems. It breaks the ecological barrier between Android and Linux, allowing you to simultaneously access a native Linux desktop environment and powerful AI development capabilities on Android phones, tablets, or edge computing devices.
Core Philosophy: Continuously lower the barrier for AI application development and achieve one-click release of edge AI computing power.
📢 Latest Updates (AidLux 2.1.0)
Release Date: March 20, 2026 Build ID: 2.1.0.1968
- New Desktop Environment: The default desktop has been upgraded from Xfce to Ubuntu-desktop, providing a more modern and complete Linux desktop experience.
- Hardware Support Expansion: The AidLite SDK now officially supports the latest chipsets including the Snapdragon 8 Gen 3 and above.
- AI Engine Upgrade: Integrated with the latest QNN (Qualcomm Neural Network) version, optimizing the底层 inference logic (AidQNN).
- Feature Enhancements:
- Re-architected and expanded WiFi management functionality.
- Optimized the installation and update logic of the Linux environment.
- The initial directory for APK installation in the App Center is now specified as internal AidLux storage, enhancing security.
- Comprehensive optimization of the Aid-Desktop interface interaction and usability.
🌟 Core Advantages
🔗 Proprietary Fusion Architecture
- Native Coexistence: Shares the Linux kernel to achieve native fusion between Android (HarmonyOS) and Linux, eliminating the need for virtual machines or dual-system reboots.
- Ecosystem Synergy: Seamlessly call Android hardware drivers (Camera, Sensors, GPS) and Linux AI software stacks (Python, ROS, OpenCV).
⚡ Ultimate Edge Computing Power Scheduling
- Heterogeneous Computing: One-click scheduling of CPU + GPU + NPU via the AidLite SDK.
- High Performance & Low Power: Deeply optimized for Qualcomm series chips, supporting INT8/FP16 quantization acceleration.
🤖 Full-Scenario AI Development Support
- On-Device LLM Deployment: Supports quantization and inference of端侧大 models (LLM/VLM) such as Qwen3 and Stable Diffusion.
- Robotics Development: Natively integrated ROS/ROS2, supporting MoveIt2 and Gazebo, making it an ideal platform for Embodied AI development.
🛠️ Core Toolchain
AidLux provides a one-stop development suite covering the entire process from coding to model deployment.
🧪 AidCode - Interactive Python IDE
- Function: A code editor designed specifically for edge AI development.
- Features:
- Supports Python syntax highlighting and code completion.
- Built-in interactive terminal supporting one-click run (
Run Now) and stop. - Supports direct calls to Android APIs (e.g., text-to-speech
droid.ttsSpeak).
🐍 Complete Linux Terminal (AidTerminal)
- Function: Provides a command-line experience consistent with native Ubuntu systems.
- Features:
- Touch Bar: A customized bottom touch bar containing
Ctrl,Alt,Tab, etc., perfectly adapting to phone/tablet touchscreens. - Multi-Terminal: Supports multiple terminal tabs simultaneously.
- Keyboard Mapping: Supports switching between external keyboards and on-screen soft keyboards.
- Touch Bar: A customized bottom touch bar containing
📦 App Center
- Function: Manages applications within the AidLux ecosystem.
- Features:
- Dual-Ecosystem Apps: Install Linux native apps (e.g., VSCode, Firefox) or add Android apps to the desktop.
- One-Click Installation: Simplifies the dependency installation process for complex software.
🤖 AI & Robotics Tools
- AidGen / AidGenSE: Generative AI inference tools and HTTP services, supporting RAG service deployment.
- AidStream: High-performance audio/video streaming framework supporting USB camera push/pull streams.
- ROS2 Humble: Pre-installed Robot Operating System supporting peripherals like LiDAR and robotic arms.
📂 File System Structure
AidLux standardizes the mapping of Android storage for easy file management:
| Directory Path | Description | Notes |
|---|---|---|
/home/aidlux |
Workspace | Default location for code and projects, the only directory supporting file uploads. |
/sdcard |
Device Storage | Corresponds to Android's internal storage, holding images (DCIM), downloads, etc. |
/media/sdi1 |
External Storage | Directory for recognized and mounted USB drives or external hard disks. |
/opt |
System Apps | Stores pre-installed SDKs and core system libraries. |
🚀 Quick Start
1. Environment Requirements
- Supported Systems: Android 7.0+, HarmonyOS, Xiaomi HyperOS
- Hardware Architecture: ARM64 devices
- Recommended Devices:
- Phones/Tablets: Xiaomi 12S/13/14/15 series, Huawei Mate/P series (selected), Samsung S series.
- Development Boards: Rhino Pi-X1, Rhino Pi-A1.
2. Installation Methods
- App Store: Search "AidLux" on Huawei, Lenovo, or Xiaomi app stores.
- Manual Installation (APK):
- Download: aidlux_2.1.0_latest_release.apk
- Note: If you encounter
Permission denied, please uninstall the old version and restart your phone before installing.
3. Development Workflow
- Connect: Access AidLux via the browser Web interface or the local desktop.
- Code: Write Python scripts using
AidCode. - Run: Capture camera feeds directly using
AidStream, or load ONNX/TensorFlow models for inference usingAidLite. - Deploy: Package the application or run it directly on the edge device.
💡 Frequently Asked Questions (FAQ)
Compiled from community feedback to help you avoid pitfalls:
Q: Why does it show "Permission denied" or fail to start after installing the new version?
- A: This is usually due to residual old version data. Please uninstall the old version, restart your phone, and then install the new APK.
Q: Why can't I find the Terminal on my phone?
- A: Please check if the full version is installed. The terminal is usually located in the "System" menu on the desktop, or search for "Terminal" in the App Center to confirm installation.
Q: Can I run software requiring
systemd(like HomeAssistant, OpenClaw) in AidLux?- A: AidLux is based on the Android kernel and does not natively support
systemd(PID 1). However, the community has developed methods to run them viaprootor specific scripts (refer to community tutorials for HomeAssistant installation).
- A: AidLux is based on the Android kernel and does not natively support
Q: How to transfer code/models between my phone and computer?
- A: We recommend using the built-in AidDesktop via browser access, or using the
scpcommand. Files must be placed in the/home/aidluxdirectory to be recognized.
- A: We recommend using the built-in AidDesktop via browser access, or using the
📚 Learning Resources
- Official Forum: AidLux Developer Community (Latest Tutorials & Q&A)
- Technical Docs: AidLux Documentation Center (Includes Rhino Pi guides)
- Model Farm: ModelFarm (400+ Optimized Models)
- Case Center: Includes tutorials for YOLOv12 deployment, MobileClip2-S3, and SAM2 、qwen3-vl deployment.
🏷️ Tags
#EdgeAI #AIoT #AndroidLinux #QualcommAI #LLM #ROS #Python #OpenSource #AidLux
Explore related projects
codecrafters-io/build-your-own-x
Master programming by recreating your favorite technologies from scratch.
559,936 starspublic-apis/public-apis
A collective list of free APIs
496,202 starsmorluto/rea
Reverse engineer anything with agents, from app behavior down to native binaries.
432,218 starsopenclaw/openclaw
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
393,935 stars