# XGO Blockly 图形化编程服务器
## 简介
XGO Blockly 是专为陆吾 XGO 机器人系列设计的图形化编程和 AI 编程服务器。通过简单的安装和启动,您可以在电脑浏览器中进行图形化编程,AI 编程,控制您的陆吾 XGO机器人。
## 支持的机型
- **XGO-Lite**：轻量级四足机器狗,680g超轻设计,适合教育入门
- **XGO-Mini**：十二自由度AI机器狗,配备机械臂和500万像素摄像头,支持AI视觉和语音识别
- **XGO-Rider**：双轮足开源开发平台,基于树莓派,560g桌面级设计,支持AI边缘计算、自稳控制和地形跨越
- **未来的机型将陆续加入。**
## 安装要求
该 pip 包需要安装在陆吾 XGO 机器人系列的树莓派机器上。
## 安装步骤
1. **进入指定目录**
```bash
cd /home/pi/RaspberryPi-CM5/
```
2. **创建或激活虚拟环境**
首先检查是否已存在 `blocklyvenv` 虚拟环境：
```bash
ls blocklyvenv
```
如果不存在，请创建虚拟环境（注意：使用 `--system-site-packages` 参数确保继承系统包，避免 Picamera2 和 libcamera 依赖问题）：
```bash
python3 -m venv --system-site-packages blocklyvenv
```
激活虚拟环境：
```bash
source blocklyvenv/bin/activate
```
3. **安装 xgo-blockly 包**
```bash
pip install xgo-blockly -i https://pypi.tuna.tsinghua.edu.cn/simple
```
**升级 xgo-blockly 包**（如果已安装）：
```bash
pip install --upgrade xgo-blockly -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install protobuf==4.25.8 -i https://pypi.tuna.tsinghua.edu.cn/simple
```
4. **单独安装 AI 识别依赖包**
由于包冲突的原因，需要单独安装 MediaPipe 等几个包：
```bash
pip install onnxruntime==1.20.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install mediapipe -i https://pypi.tuna.tsinghua.edu.cn/simple
如果安装 tensorflow 时，报错，请先清理缓存：pip cache purge
pip install tensorflow==2.15.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install ml_dtypes==0.5.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
```
## 启动服务
安装成功后，运行以下命令启动图形化编程和AI编程服务器：
```bash
xgo-blockly
```
## 使用方法
服务器启动后，在电脑上打开浏览器，访问树莓派的IP地址和端口号（默认端口号为8000，直接输入IP即可）即可开始图形化编程和AI编程。
## 功能特性
- 🎯 **图形化编程**：拖拽式编程界面，简单易用
- 🤖 **AI编程辅助**：智能代码生成和优化建议
- 🔗 **实时控制**：直接控制陆吾机器人硬件
- 🌐 **Web界面**：跨平台浏览器访问
- 📱 **响应式设计**：支持电脑、平板等设备
## 技术支持
如有问题或需要技术支持,请联系陆吾机器人技术团队。
联系方式: hello@xgorobot.com
---
# XGO Blockly Visual Programming Server
## Introduction
XGO Blockly is a visual programming and AI programming server designed specifically for the Luwu XGO robot series. Through simple installation and startup, you can perform visual programming and AI programming in your computer browser to control your Luwu XGO robot.
## Supported Models
- **XGO-Lite**: Lightweight quadruped robot dog, ultra-light 680g design, suitable for educational introduction
- **XGO-Mini**: Twelve degrees of freedom AI robot dog, equipped with robotic arm and 5-megapixel camera, supporting AI vision and voice recognition
- **XGO-Rider**: Wheeled-legged open source development platform, based on Raspberry Pi, 560g desktop-level design, supporting AI edge computing, self-balancing control and terrain crossing
- **More models will be added in the future.**
## Installation Requirements
This pip package needs to be installed on the Raspberry Pi of the Luwu XGO robot series.
## Installation Steps
1. **Navigate to the specified directory**
```bash
cd /home/pi/RaspberryPi-CM5/
```
2. **Create or activate virtual environment**
First check if the `blocklyvenv` virtual environment already exists:
```bash
ls blocklyvenv
```
If it doesn't exist, create the virtual environment (Note: Use the `--system-site-packages` parameter to ensure inheritance of system packages and avoid Picamera2 and libcamera dependency issues):
```bash
python3 -m venv --system-site-packages blocklyvenv
```
Activate the virtual environment:
```bash
source blocklyvenv/bin/activate
```
3. **Install xgo-blockly package**
```bash
pip install xgo-blockly
```
**Upgrade xgo-blockly package** (if already installed):
```bash
pip install --upgrade xgo-blockly
pip install protobuf==4.25.8
```
4. **Install AI recognition dependencies separately**
Due to package conflicts, MediaPipe and several other packages need to be installed separately:
```bash
pip install onnxruntime==1.20.0
pip install mediapipe
# If there's an error when installing tensorflow, please clear the cache first: pip cache purge
pip install tensorflow==2.15.0
pip install ml_dtypes==0.5.0
```
## Starting the Service
After successful installation, run the following command to start the visual programming and AI programming server:
```bash
xgo-blockly
```
## Usage
After the server starts, open a browser on your computer and visit the Raspberry Pi's IP address and port number (default port is 8000) to begin visual programming and AI programming.
## Features
- 🎯 **Visual Programming**: Drag-and-drop programming interface, simple and easy to use
- 🤖 **AI Programming Assistant**: Intelligent code generation and optimization suggestions
- 🔗 **Real-time Control**: Direct control of Luwu robot hardware
- 🌐 **Web Interface**: Cross-platform browser access
- 📱 **Responsive Design**: Supports computers, tablets and other devices
## Technical Support
If you have any questions or need technical support, please contact the Luwu Robotics technical team.
Contact: hello@xgorobot.com
Raw data
{
"_id": null,
"home_page": "https://github.com/xgo-robotics/xgo-blockly",
"name": "xgo-blockly",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "xgo, robot, blockly, programming, education",
"author": "\u9646\u543e\u79d1\u6280",
"author_email": "\u9646\u543e\u79d1\u6280 <hello@xgorobot.com>",
"download_url": "https://files.pythonhosted.org/packages/72/f7/f26b4cdf94ff6268f830625799e947a4593bb1c7c18caa511b942ba2621e/xgo_blockly-0.0.0.3.tar.gz",
"platform": null,
"description": "# XGO Blockly \u56fe\u5f62\u5316\u7f16\u7a0b\u670d\u52a1\u5668\r\n\r\n## \u7b80\u4ecb\r\n\r\nXGO Blockly \u662f\u4e13\u4e3a\u9646\u543e XGO \u673a\u5668\u4eba\u7cfb\u5217\u8bbe\u8ba1\u7684\u56fe\u5f62\u5316\u7f16\u7a0b\u548c AI \u7f16\u7a0b\u670d\u52a1\u5668\u3002\u901a\u8fc7\u7b80\u5355\u7684\u5b89\u88c5\u548c\u542f\u52a8,\u60a8\u53ef\u4ee5\u5728\u7535\u8111\u6d4f\u89c8\u5668\u4e2d\u8fdb\u884c\u56fe\u5f62\u5316\u7f16\u7a0b,AI \u7f16\u7a0b,\u63a7\u5236\u60a8\u7684\u9646\u543e XGO\u673a\u5668\u4eba\u3002\r\n\r\n## \u652f\u6301\u7684\u673a\u578b\r\n\r\n- **XGO-Lite**\uff1a\u8f7b\u91cf\u7ea7\u56db\u8db3\u673a\u5668\u72d7,680g\u8d85\u8f7b\u8bbe\u8ba1,\u9002\u5408\u6559\u80b2\u5165\u95e8\r\n- **XGO-Mini**\uff1a\u5341\u4e8c\u81ea\u7531\u5ea6AI\u673a\u5668\u72d7,\u914d\u5907\u673a\u68b0\u81c2\u548c500\u4e07\u50cf\u7d20\u6444\u50cf\u5934,\u652f\u6301AI\u89c6\u89c9\u548c\u8bed\u97f3\u8bc6\u522b\r\n- **XGO-Rider**\uff1a\u53cc\u8f6e\u8db3\u5f00\u6e90\u5f00\u53d1\u5e73\u53f0,\u57fa\u4e8e\u6811\u8393\u6d3e,560g\u684c\u9762\u7ea7\u8bbe\u8ba1,\u652f\u6301AI\u8fb9\u7f18\u8ba1\u7b97\u3001\u81ea\u7a33\u63a7\u5236\u548c\u5730\u5f62\u8de8\u8d8a\r\n\r\n- **\u672a\u6765\u7684\u673a\u578b\u5c06\u9646\u7eed\u52a0\u5165\u3002**\r\n\r\n## \u5b89\u88c5\u8981\u6c42\r\n\r\n\u8be5 pip \u5305\u9700\u8981\u5b89\u88c5\u5728\u9646\u543e XGO \u673a\u5668\u4eba\u7cfb\u5217\u7684\u6811\u8393\u6d3e\u673a\u5668\u4e0a\u3002\r\n\r\n## \u5b89\u88c5\u6b65\u9aa4\r\n\r\n1. **\u8fdb\u5165\u6307\u5b9a\u76ee\u5f55**\r\n ```bash\r\n cd /home/pi/RaspberryPi-CM5/\r\n ```\r\n\r\n2. **\u521b\u5efa\u6216\u6fc0\u6d3b\u865a\u62df\u73af\u5883**\r\n \r\n \u9996\u5148\u68c0\u67e5\u662f\u5426\u5df2\u5b58\u5728 `blocklyvenv` \u865a\u62df\u73af\u5883\uff1a\r\n ```bash\r\n ls blocklyvenv\r\n ```\r\n \r\n \u5982\u679c\u4e0d\u5b58\u5728\uff0c\u8bf7\u521b\u5efa\u865a\u62df\u73af\u5883\uff08\u6ce8\u610f\uff1a\u4f7f\u7528 `--system-site-packages` \u53c2\u6570\u786e\u4fdd\u7ee7\u627f\u7cfb\u7edf\u5305\uff0c\u907f\u514d Picamera2 \u548c libcamera \u4f9d\u8d56\u95ee\u9898\uff09\uff1a\r\n ```bash\r\n python3 -m venv --system-site-packages blocklyvenv\r\n ```\r\n \r\n \u6fc0\u6d3b\u865a\u62df\u73af\u5883\uff1a\r\n ```bash\r\n source blocklyvenv/bin/activate\r\n ```\r\n\r\n3. **\u5b89\u88c5 xgo-blockly \u5305**\r\n ```bash\r\n pip install xgo-blockly -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n ```\r\n \r\n **\u5347\u7ea7 xgo-blockly \u5305**\uff08\u5982\u679c\u5df2\u5b89\u88c5\uff09\uff1a\r\n ```bash\r\n pip install --upgrade xgo-blockly -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n pip install protobuf==4.25.8 -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n ```\r\n\r\n4. **\u5355\u72ec\u5b89\u88c5 AI \u8bc6\u522b\u4f9d\u8d56\u5305**\r\n \r\n \u7531\u4e8e\u5305\u51b2\u7a81\u7684\u539f\u56e0\uff0c\u9700\u8981\u5355\u72ec\u5b89\u88c5 MediaPipe \u7b49\u51e0\u4e2a\u5305\uff1a\r\n ```bash\r\n pip install onnxruntime==1.20.0 -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n pip install mediapipe -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n \u5982\u679c\u5b89\u88c5 tensorflow \u65f6\uff0c\u62a5\u9519\uff0c\u8bf7\u5148\u6e05\u7406\u7f13\u5b58\uff1apip cache purge\r\n pip install tensorflow==2.15.0 -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n pip install ml_dtypes==0.5.0 -i https://pypi.tuna.tsinghua.edu.cn/simple\r\n ```\r\n\r\n## \u542f\u52a8\u670d\u52a1\r\n\r\n\u5b89\u88c5\u6210\u529f\u540e\uff0c\u8fd0\u884c\u4ee5\u4e0b\u547d\u4ee4\u542f\u52a8\u56fe\u5f62\u5316\u7f16\u7a0b\u548cAI\u7f16\u7a0b\u670d\u52a1\u5668\uff1a\r\n\r\n```bash\r\nxgo-blockly\r\n```\r\n\r\n## \u4f7f\u7528\u65b9\u6cd5\r\n\r\n\u670d\u52a1\u5668\u542f\u52a8\u540e\uff0c\u5728\u7535\u8111\u4e0a\u6253\u5f00\u6d4f\u89c8\u5668\uff0c\u8bbf\u95ee\u6811\u8393\u6d3e\u7684IP\u5730\u5740\u548c\u7aef\u53e3\u53f7\uff08\u9ed8\u8ba4\u7aef\u53e3\u53f7\u4e3a8000\uff0c\u76f4\u63a5\u8f93\u5165IP\u5373\u53ef\uff09\u5373\u53ef\u5f00\u59cb\u56fe\u5f62\u5316\u7f16\u7a0b\u548cAI\u7f16\u7a0b\u3002\r\n\r\n## \u529f\u80fd\u7279\u6027\r\n\r\n- \ud83c\udfaf **\u56fe\u5f62\u5316\u7f16\u7a0b**\uff1a\u62d6\u62fd\u5f0f\u7f16\u7a0b\u754c\u9762\uff0c\u7b80\u5355\u6613\u7528\r\n- \ud83e\udd16 **AI\u7f16\u7a0b\u8f85\u52a9**\uff1a\u667a\u80fd\u4ee3\u7801\u751f\u6210\u548c\u4f18\u5316\u5efa\u8bae\r\n- \ud83d\udd17 **\u5b9e\u65f6\u63a7\u5236**\uff1a\u76f4\u63a5\u63a7\u5236\u9646\u543e\u673a\u5668\u4eba\u786c\u4ef6\r\n- \ud83c\udf10 **Web\u754c\u9762**\uff1a\u8de8\u5e73\u53f0\u6d4f\u89c8\u5668\u8bbf\u95ee\r\n- \ud83d\udcf1 **\u54cd\u5e94\u5f0f\u8bbe\u8ba1**\uff1a\u652f\u6301\u7535\u8111\u3001\u5e73\u677f\u7b49\u8bbe\u5907\r\n\r\n## \u6280\u672f\u652f\u6301\r\n\r\n\u5982\u6709\u95ee\u9898\u6216\u9700\u8981\u6280\u672f\u652f\u6301,\u8bf7\u8054\u7cfb\u9646\u543e\u673a\u5668\u4eba\u6280\u672f\u56e2\u961f\u3002\r\n\r\n\u8054\u7cfb\u65b9\u5f0f: hello@xgorobot.com\r\n\r\n---\r\n\r\n# XGO Blockly Visual Programming Server\r\n\r\n## Introduction\r\n\r\nXGO Blockly is a visual programming and AI programming server designed specifically for the Luwu XGO robot series. Through simple installation and startup, you can perform visual programming and AI programming in your computer browser to control your Luwu XGO robot.\r\n\r\n## Supported Models\r\n\r\n- **XGO-Lite**: Lightweight quadruped robot dog, ultra-light 680g design, suitable for educational introduction\r\n- **XGO-Mini**: Twelve degrees of freedom AI robot dog, equipped with robotic arm and 5-megapixel camera, supporting AI vision and voice recognition\r\n- **XGO-Rider**: Wheeled-legged open source development platform, based on Raspberry Pi, 560g desktop-level design, supporting AI edge computing, self-balancing control and terrain crossing\r\n\r\n- **More models will be added in the future.**\r\n\r\n## Installation Requirements\r\n\r\nThis pip package needs to be installed on the Raspberry Pi of the Luwu XGO robot series.\r\n\r\n## Installation Steps\r\n\r\n1. **Navigate to the specified directory**\r\n ```bash\r\n cd /home/pi/RaspberryPi-CM5/\r\n ```\r\n\r\n2. **Create or activate virtual environment**\r\n \r\n First check if the `blocklyvenv` virtual environment already exists:\r\n ```bash\r\n ls blocklyvenv\r\n ```\r\n \r\n If it doesn't exist, create the virtual environment (Note: Use the `--system-site-packages` parameter to ensure inheritance of system packages and avoid Picamera2 and libcamera dependency issues):\r\n ```bash\r\n python3 -m venv --system-site-packages blocklyvenv\r\n ```\r\n \r\n Activate the virtual environment:\r\n ```bash\r\n source blocklyvenv/bin/activate\r\n ```\r\n\r\n3. **Install xgo-blockly package**\r\n ```bash\r\n pip install xgo-blockly\r\n ```\r\n \r\n **Upgrade xgo-blockly package** (if already installed):\r\n ```bash\r\n pip install --upgrade xgo-blockly\r\n pip install protobuf==4.25.8\r\n ```\r\n\r\n4. **Install AI recognition dependencies separately**\r\n \r\n Due to package conflicts, MediaPipe and several other packages need to be installed separately:\r\n ```bash\r\n pip install onnxruntime==1.20.0\r\n pip install mediapipe\r\n # If there's an error when installing tensorflow, please clear the cache first: pip cache purge\r\n pip install tensorflow==2.15.0\r\n pip install ml_dtypes==0.5.0\r\n ```\r\n\r\n## Starting the Service\r\n\r\nAfter successful installation, run the following command to start the visual programming and AI programming server:\r\n\r\n```bash\r\nxgo-blockly\r\n```\r\n\r\n## Usage\r\n\r\nAfter the server starts, open a browser on your computer and visit the Raspberry Pi's IP address and port number (default port is 8000) to begin visual programming and AI programming.\r\n\r\n## Features\r\n\r\n- \ud83c\udfaf **Visual Programming**: Drag-and-drop programming interface, simple and easy to use\r\n- \ud83e\udd16 **AI Programming Assistant**: Intelligent code generation and optimization suggestions\r\n- \ud83d\udd17 **Real-time Control**: Direct control of Luwu robot hardware\r\n- \ud83c\udf10 **Web Interface**: Cross-platform browser access\r\n- \ud83d\udcf1 **Responsive Design**: Supports computers, tablets and other devices\r\n\r\n## Technical Support\r\n\r\nIf you have any questions or need technical support, please contact the Luwu Robotics technical team.\r\n\r\nContact: hello@xgorobot.com\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "XGO Blockly - \u56fe\u5f62\u5316\u548c AI \u7f16\u7a0b Web \u670d\u52a1\u5668",
"version": "0.0.0.3",
"project_urls": {
"Bug Reports": "https://github.com/xgo-robotics/xgo-blockly/issues",
"Documentation": "https://docs.xgo.com/",
"Homepage": "https://github.com/xgo-robotics/xgo-blockly",
"Source": "https://github.com/xgo-robotics/xgo-blockly"
},
"split_keywords": [
"xgo",
" robot",
" blockly",
" programming",
" education"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d0bab29605e58240ed747d99444e3787ee604ae4818889b44020464e9add2a69",
"md5": "66a2d030b59232c23691c66e264bec11",
"sha256": "f87bea298707e1f7c2860d0081cbfcc82f887384c4bc325b9ae3208327014bcd"
},
"downloads": -1,
"filename": "xgo_blockly-0.0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "66a2d030b59232c23691c66e264bec11",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 1047879,
"upload_time": "2025-10-22T07:47:57",
"upload_time_iso_8601": "2025-10-22T07:47:57.662377Z",
"url": "https://files.pythonhosted.org/packages/d0/ba/b29605e58240ed747d99444e3787ee604ae4818889b44020464e9add2a69/xgo_blockly-0.0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "72f7f26b4cdf94ff6268f830625799e947a4593bb1c7c18caa511b942ba2621e",
"md5": "a738937bd8d1b32c8fc771d264c24547",
"sha256": "6f2d326d10624205ebc20c69af03ad9aac45e4857484c01f492baec41f46f2fa"
},
"downloads": -1,
"filename": "xgo_blockly-0.0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "a738937bd8d1b32c8fc771d264c24547",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 1038451,
"upload_time": "2025-10-22T07:48:00",
"upload_time_iso_8601": "2025-10-22T07:48:00.115878Z",
"url": "https://files.pythonhosted.org/packages/72/f7/f26b4cdf94ff6268f830625799e947a4593bb1c7c18caa511b942ba2621e/xgo_blockly-0.0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 07:48:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "xgo-robotics",
"github_project": "xgo-blockly",
"github_not_found": true,
"lcname": "xgo-blockly"
}
JSON
