Skip to content

Commit add084c

Browse files
qidisoqidiso
authored
Update README-en.md
1 parent 394575b commit add084c

1 file changed

Lines changed: 89 additions & 106 deletions

File tree

‎README-en.md‎

Lines changed: 89 additions & 106 deletions
Original file line numberDiff line numberDiff line change
@@ -1,157 +1,140 @@
1-
# 🚀 AidLux - ARM Architecture Edge AIoT Fusion Development Platform
1+
# 🚀 AidLux - ARM-based Edge AIoT Fusion Development Platform
22

3-
**AidLux** is a cross-ecosystem (Android/HarmonyOS + Linux) one-stop AIoT application development and deployment platform based on ARM architecture. It breaks the ecological barriers between Android and Linux, allowing you to simultaneously obtain native Linux desktop environment and AI development capabilities on Android phones, tablets, or edge computing devices.
3+
[![Release](https://img.shields.io/badge/Version-2.1.0-green)](https://github.com/aidlux/AidLux)
4+
[![License](https://img.shields.io/badge/License-Apache--2.0-blue)](LICENSE)
5+
[![Platform](https://img.shields.io/badge/Platform-Android%20%7C%20HarmonyOS%20%7C%20HyperOS-orange)]()
46

5-
**Core Concept**: Continuously lower the threshold of AI application development and achieve one-click release of edge AI computing power.
7+
**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.
8+
9+
> **Core Philosophy**: Continuously lower the门槛 for AI application development and achieve one-click release of edge AI computing power.
10+
11+
---
612

713
## 📢 Latest Updates (AidLux 2.1.0)
814

915
**Release Date**: March 20, 2026
1016
**Build ID**: 2.1.0.1968
1117

12-
- **New Desktop Environment**: Default desktop environment upgraded from Xfce to **Ubuntu-desktop**, providing a more modern and complete Linux desktop experience.
13-
- **Hardware Support Expansion**: **AidLite SDK** now officially supports **Snapdragon 8 Gen 3** and above latest chipsets.
14-
- **AI Engine Upgrade**: Integrated updated **QNN (Qualcomm Neural Network)** version with optimized底层推理 logic (AidQNN).
15-
- **Feature Enhancements**:
16-
- Reconstructed and expanded WiFi management functions.
17-
- Optimized Linux environment installation and update logic, fixing some update issues.
18-
- Specified internal storage of AidLux as the initial directory for APK installation in the application center, enhancing security.
19-
- **Aid-Desktop** interface interaction and usability comprehensively optimized.
18+
* **New Desktop Environment**: The default desktop has been upgraded from Xfce to **Ubuntu-desktop**, providing a more modern and complete Linux desktop experience.
19+
* **Hardware Support Expansion**: The **AidLite SDK** now officially supports the latest chipsets including the **Snapdragon 8 Gen 3** and above.
20+
* **AI Engine Upgrade**: Integrated with the latest **QNN (Qualcomm Neural Network)** version, optimizing the底层 inference logic (AidQNN).
21+
* **Feature Enhancements**:
22+
* Re-architected and expanded WiFi management functionality.
23+
* Optimized the installation and update logic of the Linux environment.
24+
* The initial directory for APK installation in the App Center is now specified as internal AidLux storage, enhancing security.
25+
* Comprehensive optimization of the **Aid-Desktop** interface interaction and usability.
2026

2127
---
2228

2329
## 🌟 Core Advantages
2430

25-
### 1. Innovative Fusion Architecture
26-
27-
- **Native Coexistence**: Shares Linux kernel to achieve native fusion of Android (HarmonyOS) and Linux, without virtual machines or dual system restart.
28-
- **Ecosystem Complementarity**: Seamlessly calls Android hardware drivers (camera, sensors, GPS) and Linux AI software stack (Python, ROS, OpenCV).
31+
### 🔗 Proprietary Fusion Architecture
32+
* **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.
33+
* **Ecosystem Synergy**: Seamlessly call Android hardware drivers (Camera, Sensors, GPS) and Linux AI software stacks (Python, ROS, OpenCV).
2934

30-
### 2. Ultimate Edge Computing Power Scheduling
35+
### ⚡ Ultimate Edge Computing Power Scheduling
36+
* **Heterogeneous Computing**: One-click scheduling of CPU + GPU + NPU via the AidLite SDK.
37+
* **High Performance & Low Power**: Deeply optimized for Qualcomm series chips, supporting INT8/FP16 quantization acceleration.
3138

32-
- **Heterogeneous Computing**: One-click scheduling of CPU + GPU + NPU through AidLite SDK.
33-
- **High Performance & Low Power**: Deeply optimized for Qualcomm series chips, supporting INT8/FP16 quantization acceleration.
34-
35-
### 3. Full-Scenario AI Development Support
36-
37-
- **Edge Large Model Deployment**: Supports quantization and inference of edge large models (LLM/VLM) such as Qwen3, Stable Diffusion.
38-
- **Robotics Development**: Natively integrated ROS/ROS2, supporting MoveIt2 and Gazebo, ideal platform for embodied intelligence development.
39+
### 🤖 Full-Scenario AI Development Support
40+
* **On-Device LLM Deployment**: Supports quantization and inference of端侧大 models (LLM/VLM) such as Qwen3 and Stable Diffusion.
41+
* **Robotics Development**: Natively integrated ROS/ROS2, supporting MoveIt2 and Gazebo, making it an ideal platform for Embodied AI development.
3942

4043
---
4144

42-
## 🛠️ Core Toolchain & Development Environment
45+
## 🛠️ Core Toolchain
4346

44-
AidLux provides an all-in-one development tool covering the entire process from code writing to model deployment.
47+
AidLux provides a one-stop development suite covering the entire process from coding to model deployment.
4548

4649
### 🧪 AidCode - Interactive Python IDE
47-
48-
- **Function**: Code editor designed specifically for edge AI development.
49-
- **Features**:
50-
- Supports Python syntax highlighting and code completion.
51-
- Built-in interactive terminal with one-click run (`Run Now`) and stop functions.
52-
- Supports direct calling of Android APIs (such as voice broadcast `droid.ttsSpeak`).
50+
* **Function**: A code editor designed specifically for edge AI development.
51+
* **Features**:
52+
* Supports Python syntax highlighting and code completion.
53+
* Built-in interactive terminal supporting one-click run (`Run Now`) and stop.
54+
* Supports direct calls to Android APIs (e.g., text-to-speech `droid.ttsSpeak`).
5355

5456
### 🐍 Complete Linux Terminal (AidTerminal)
55-
56-
- **Function**: Provides command-line experience consistent with native Ubuntu systems.
57-
- **Features**:
58-
- **Touch Bar**: Bottom customized touch bar with `Ctrl`, `Alt`, `Tab` and other combination keys, perfectly adapted to mobile/tablet touch screens.
59-
- **Multi-terminal**: Supports opening multiple terminal tabs simultaneously without interference.
60-
- **Keyboard Mapping**: Supports switching between external keyboards and on-screen soft keyboards.
61-
62-
### 📦 Application Center
63-
64-
- **Function**: Manages applications in the AidLux ecosystem.
65-
- **Features**:
66-
- **Dual-ecosystem Applications**: Can install both native Linux applications (like VSCode, Firefox) and add Android applications to the desktop.
67-
- **One-click Installation**: Simplifies dependency installation process for complex software.
57+
* **Function**: Provides a command-line experience consistent with native Ubuntu systems.
58+
* **Features**:
59+
* **Touch Bar**: A customized bottom touch bar containing `Ctrl`, `Alt`, `Tab`, etc., perfectly adapting to phone/tablet touchscreens.
60+
* **Multi-Terminal**: Supports multiple terminal tabs simultaneously.
61+
* **Keyboard Mapping**: Supports switching between external keyboards and on-screen soft keyboards.
62+
63+
### 📦 App Center
64+
* **Function**: Manages applications within the AidLux ecosystem.
65+
* **Features**:
66+
* **Dual-Ecosystem Apps**: Install Linux native apps (e.g., VSCode, Firefox) or add Android apps to the desktop.
67+
* **One-Click Installation**: Simplifies the dependency installation process for complex software.
6868

6969
### 🤖 AI & Robotics Tools
70-
71-
- **AidGen / AidGenSE**: Generative AI inference tools and HTTP services, supporting RAG service deployment.
72-
- **AidStream**: High-performance audio/video streaming framework supporting USB camera push/pull streaming.
73-
- **ROS2 Humble**: Pre-installed robotics operating system supporting peripherals like LiDAR and robotic arms.
74-
75-
---
76-
77-
## 🏷️ Model Zoo & Ecosystem Resources
78-
79-
AidLux is not just a development environment, but also the world's first **Qualcomm IoT Platform Edge AI Ecosystem Portal**. We provide abundant ready-made resources to help you seamlessly transition from "idea" to "deployment".
80-
81-
### 🏷️ Model Zoo
82-
83-
We offer over **400+** mainstream AI models covering computer vision, speech audio, natural language processing, and multimodal fields.
84-
85-
- **Plug-and-Play**: All models are deeply optimized, supporting one-click download and deployment.
86-
- **Real-device Benchmark Data**: Provides detailed performance metrics, allowing you to clearly understand model performance on different Qualcomm platforms (like QCS8550, QCS6490).
87-
- **Popular Models**:
88-
- **Object Detection**: YOLOv8 (s/m/n), YOLOv5
89-
- **Segmentation & Tracking**: SAM2, MobileSAM
90-
- **Classification & Recognition**: MobileNet, ResNet, MobileClip
91-
- **Generative AI**: Stable Diffusion, Qwen-VL (multimodal large models)
92-
93-
### ⚡ Rapid Deployment Tools
94-
95-
Through the built-in **MMS (Model Management System)** tool, developers can directly pull models from the command line:
96-
97-
```
98-
# Login to Model Zoo
99-
mms login -u <username> -p <password>
100-
101-
# Search models
102-
mms list yolov8
103-
104-
# One-click download models optimized for specific chips (e.g., QCS8550, INT8 precision)
105-
mms get -m yolov8m -p int8 -c qcs8550 -b qnn2.36
106-
```
70+
* **AidGen / AidGenSE**: Generative AI inference tools and HTTP services, supporting RAG service deployment.
71+
* **AidStream**: High-performance audio/video streaming framework supporting USB camera push/pull streams.
72+
* **ROS2 Humble**: Pre-installed Robot Operating System supporting peripherals like LiDAR and robotic arms.
10773

10874
---
10975

11076
## 📂 File System Structure
11177

112-
AidLux standardizes Android storage mapping for convenient file management:
78+
AidLux standardizes the mapping of Android storage for easy file management:
11379

11480
| Directory Path | Description | Notes |
115-
| ------ |------ |------ |
116-
| `/home/aidlux` | **Working Directory** | Default location for code and projects, **the only directory supporting file upload**. |
117-
| `/sdcard` | **Device Storage** | Corresponds to Android internal storage, storing images (`DCIM`), downloads, etc. |
118-
| `/media/sdi1` | **External Storage** | Recognized and mounted USB drives or external hard disk directories. |
119-
| `/opt` | **System Applications** | Stores pre-installed SDKs and core system libraries. |
81+
| :--- | :--- | :--- |
82+
| `/home/aidlux` | **Workspace** | Default location for code and projects, the **only directory supporting file uploads**. |
83+
| `/sdcard` | **Device Storage** | Corresponds to Android's internal storage, holding images (`DCIM`), downloads, etc. |
84+
| `/media/sdi1` | **External Storage** | Directory for recognized and mounted USB drives or external hard disks. |
85+
| `/opt` | **System Apps** | Stores pre-installed SDKs and core system libraries. |
12086

12187
---
12288

12389
## 🚀 Quick Start
12490

125-
### Environment Requirements
91+
### 1. Environment Requirements
92+
* **Supported Systems**: Android 7.0+, HarmonyOS, Xiaomi HyperOS
93+
* **Hardware Architecture**: ARM64 devices
94+
* **Recommended Devices**:
95+
* **Phones/Tablets**: Xiaomi 12S/13/14/15 series, Huawei Mate/P series (selected), Samsung S series.
96+
* **Development Boards**: Rhino Pi-X1, Rhino Pi-A1.
97+
98+
### 2. Installation Methods
99+
* **App Store**: Search "AidLux" on Huawei, Lenovo, or Xiaomi app stores.
100+
* **Manual Installation (APK)**:
101+
* Download: [aidlux_2.1.0_latest_release.apk](https://file.aidlux.com/repo/apk/aidlux_2.1.0_latest_release.apk)
102+
* **Note**: If you encounter `Permission denied`, please uninstall the old version and restart your phone before installing.
103+
104+
### 3. Development Workflow
105+
1. **Connect**: Access AidLux via the browser Web interface or the local desktop.
106+
2. **Code**: Write Python scripts using `AidCode`.
107+
3. **Run**: Capture camera feeds directly using `AidStream`, or load ONNX/TensorFlow models for inference using `AidLite`.
108+
4. **Deploy**: Package the application or run it directly on the edge device.
109+
110+
---
126111

127-
- **Supported Systems**: Android, HarmonyOS, Xiaomi HyperOS
128-
- **Hardware Architecture**: ARM64 devices (supports Snapdragon 8 Gen 3, 865, 6490, etc.)
112+
## 💡 Frequently Asked Questions (FAQ)
129113

130-
### Installation Methods
114+
Compiled from community feedback to help you avoid pitfalls:
131115

132-
1. **App Store**: Huawei, Lenovo devices can directly search "AidLux" in the app store.
133-
2. **Manual Installation**:
134-
- Download APK: AidLux 2.1.0 Latest Release
135-
- First launch after installation requires network configuration of Linux environment (about 1-3 minutes).
116+
* **Q: Why does it show "Permission denied" or fail to start after installing the new version?**
117+
* A: This is usually due to residual old version data. Please **uninstall the old version**, **restart your phone**, and then install the new APK.
136118

137-
### Development Workflow
119+
* **Q: Why can't I find the Terminal on my phone?**
120+
* 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.
138121

139-
1. **Connect**: Access AidLux through browser web interface or local desktop.
140-
2. **Code**: Use `AidCode` to write Python scripts.
141-
3. **Run**: Directly call `AidStream` to capture camera footage, or use `AidLite` to load ONNX/TensorFlow models for inference.
142-
4. **Deploy**: Package applications or run directly on edge devices.
122+
* **Q: Can I run software requiring `systemd` (like HomeAssistant, OpenClaw) in AidLux?**
123+
* 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 via `proot` or specific scripts (refer to community tutorials for HomeAssistant installation).
124+
125+
* **Q: How to transfer code/models between my phone and computer?**
126+
* A: We recommend using the built-in **AidDesktop** via browser access, or using the `scp` command. Files must be placed in the `/home/aidlux` directory to be recognized.
143127

144128
---
145129

146130
## 📚 Learning Resources
147131

148-
- **Official Forum**: AidLux Developer Community
149-
- **Technical Documentation**: AidLux Documentation Center
150-
- **Case Center**: Practical tutorials including YOLOv5 deployment, MobileClip2-S3, SAM2 deployment, etc.
132+
* **Official Forum**: [AidLux Developer Community (Latest Tutorials & Q&A)](https://forum.aidlux.com)
133+
* **Technical Docs**: [AidLux Documentation Center (Includes Rhino Pi guides)](https://rhinopi.docs.aidlux.com)
134+
* **Model Farm**: [ModelFarm (400+ Optimized Models)](https://aiot.aidlux.com/en/models)
135+
* **Case Center**: Includes实战 tutorials for YOLOv8 deployment, MobileClip2-S3, and SAM2 deployment.
151136

152137
---
153138

154139
## 🏷️ Tags
155-
156-
#EdgeAI #AIoT #AndroidLinux #QualcommAI #LargeModelDeployment #ROS #Python #OpenSource
157-
140+
#EdgeAI #AIoT #AndroidLinux #QualcommAI #LLM #ROS #Python #OpenSource #AidLux

0 commit comments

Comments
 (0)