Metadata-Version: 2.4
Name: xgo-blockly-luwuos
Version: 1.0.0.6
Summary: XGO Blockly - 图形化和 AI 编程 Web 服务器
Home-page: https://github.com/xgo-robotics/xgo-blockly
Author: 陆吾科技
Author-email: 陆吾科技 <hello@xgorobot.com>
License: MIT
Project-URL: Homepage, https://github.com/xgo-robotics/xgo-blockly
Project-URL: Bug Reports, https://github.com/xgo-robotics/xgo-blockly/issues
Project-URL: Source, https://github.com/xgo-robotics/xgo-blockly
Project-URL: Documentation, https://docs.xgo.com/
Keywords: xgo,robot,blockly,programming,education
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Education
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Flask
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: flask>=2.2.2
Requires-Dist: flask-cors>=4.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: pyserial>=3.5
Requires-Dist: mem0ai<2.0.0,>=0.1.118
Requires-Dist: agentscope>=1.0.19
Requires-Dist: opencv-python>=4.11.0.86
Requires-Dist: packaging>=23.2
Requires-Dist: requests>=2.32.3
Requires-Dist: pyzbar>=0.1.9
Requires-Dist: websockets>=11.0
Requires-Dist: websocket-client>=1.6.0
Requires-Dist: pyaudio>=0.2.13
Requires-Dist: dashscope>=1.14.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# XGO Blockly 图形化编程服务器

## 简介

XGO Blockly 是专为陆吾 XGO 机器人系列设计的图形化编程和 AI 编程服务器。通过简单的安装和启动,您可以在电脑浏览器中进行图形化编程,AI 编程,控制您的陆吾 XGO机器人。

## 支持的机型

- **XGO-Lite**：轻量级四足机器狗,680g超轻设计,适合教育入门
- **XGO-Mini**：十二自由度AI机器狗,配备机械臂和500万像素摄像头,支持AI视觉和语音识别
- **XGO-Rider**：双轮足开源开发平台,基于树莓派,560g桌面级设计,支持AI边缘计算、自稳控制和地形跨越

- **未来的机型将陆续加入。**

## 安装要求

该 pip 包需要安装在陆吾 XGO 机器人系列的树莓派机器上。

## 安装步骤


1. **安装 xgo-blockly-luwuos 包**
   ```bash
   pip install xgo-blockly-luwuos -i https://pypi.tuna.tsinghua.edu.cn/simple
   ```
   
   **升级 xgo-blockly-luwuos 包**（如果已安装）：
   ```bash
   pip install --upgrade xgo-blockly-luwuos -i https://pypi.tuna.tsinghua.edu.cn/simple
   ```

## 启动服务

安装成功后，运行以下命令启动图形化编程和AI编程服务器：

```bash
xgo-blockly
```

## 使用方法

服务器启动后，在电脑上打开浏览器，访问树莓派的IP地址和端口号（默认端口号为8000，直接输入IP即可）即可开始图形化编程和AI编程。

## 功能特性

- 🎯 **图形化编程**：拖拽式编程界面，简单易用
- 🤖 **AI编程辅助**：智能代码生成和优化建议
- 🔗 **实时控制**：直接控制陆吾机器人硬件
- 🌐 **Web界面**：跨平台浏览器访问
- 📱 **响应式设计**：支持电脑、平板等设备

## 版本更新记录

### v1.0.6.5

1. 新增实时模式，双击执行，同一个 Python 执行器环境
2. 新增网页 SSH，有文件管理功能，和常用命令
3. 新增摄像头标定，用户使用 AprilTag 定位距离方向等
4. 新增自动 import 功能
5. 运动库分区排列优化
6. 其他小功能升级改动

### v1.0.0.1

1. 调整 A、B 按键映射
2. 增加豆包大模型开通管理引导

## 技术支持

如有问题或需要技术支持,请联系陆吾机器人技术团队。

联系方式: 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. **Install xgo-blockly-luwuos package**
   ```bash
   pip install xgo-blockly-luwuos
   ```
   
   **Upgrade xgo-blockly-luwuos package** (if already installed):
   ```bash
   pip install --upgrade xgo-blockly-luwuos
   ```

## 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

## Version History

### v1.0.6.5

1. Added real-time mode: double-click to execute blocks in a shared Python executor environment
2. Added web-based SSH terminal with file manager and common commands
3. Added camera calibration with AprilTag for distance and orientation positioning
4. Added auto-import functionality
5. Optimized motion library category layout
6. Other minor feature upgrades and improvements

### v1.0.0.1

1. Adjusted A and B button mapping
2. Added Doubao AI model activation and management guide

## Technical Support

If you have any questions or need technical support, please contact the Luwu Robotics technical team.

Contact: hello@xgorobot.com
