Booster OS
Booster Robotics 机器人操作系统核心 SDK
旨在为人形机器人提供统一、高效、易用的开发接口。
💡 为什么选择 Booster OS?
- 统一抽象:一套代码适配多种机器人硬件(Booster K1, Unitree 等)。
- 感控一体:原生集成视觉检测(Detection)与运动控制。
- 异步驱动:基于任务句柄(TaskHandle)的非阻塞控制架构。
📖 文档索引
如果你需要深入了解某个模块,请查阅以下专门文档:
- 📚 API 参考手册 - 包含所有类、方法及参数的详细说明。
- 🎙️ Speech 接入说明 - 语音服务接入说明。
🛠️ 安装
1. 系统级依赖 (ROS 2)
本项目部分核心功能依赖 ROS 2 Humble。在安装 Python 包前,请确保系统已安装:
# 安装 rclpy 和 cv_bridge 核心组件
sudo apt update && sudo apt install ros-humble-rclpy ros-humble-cv-bridge
并在终端运行前 source 环境:
source /opt/ros/humble/setup.bash
2. 通过 pip 安装
# 基础控制版本
pip install boosteros
# 包含 AI/感知(brain)插件版本
pip install boosteros[brain]
🚀 核心组件概览
1. 机器人控制 (BoosterRobot)
from boosteros.robots.booster import BoosterRobot
robot = BoosterRobot()
robot.set_mode("walk")
robot.set_velocity(vx=0.2, vy=0.0, vyaw=0.0) # 让机器人走起来
2. AI 视觉 (Detection)
from boosteros.brain import Detection
detector = Detection(model="person")
img = robot.get_image() # 获取实时图像
results = detector.detect(img.to_numpy()) # 执行目标检测
📂 目录结构
src/boosteros/base/: 核心抽象类(Robot, AudioManager 等)。src/boosteros/robots/: 不同型号机器人的具体实现(Booster, Unitree 等)。src/boosteros/brain/: AI 与高级感知模块(视觉检测、大模型集成等)。src/boosteros/types/: 跨模块通用的强类型数据定义。examples/: 丰富的实战示例代码。
Metadata
Release files for boosteros 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| boosteros-1.2.0.tar.gz | 71.5 MB | Without provenance | Details for boosteros-1.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| boosteros-1.2.0-py3-none-any.whl | Python 3 | none | any | Details for boosteros-1.2.0-py3-none-any.whl |
Total release size: 142.2 MB
Release files / boosteros-1.2.0.tar.gz
| Download URL | boosteros-1.2.0.tar.gz |
|---|---|
| Size | 71.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0d1c4b66f1ad45ef3c45f5ba8e6d1fadadd6573bd17cf1cd5f82a271b8e4f2be
|
|
BLAKE2b-256 checksum How to use checksums |
4445c93c8d9997a9c1c09c6515b137fa5d5dcaafc5ba1060de3d42ffa3a2eef9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Release files / boosteros-1.2.0-py3-none-any.whl
| Download URL | boosteros-1.2.0-py3-none-any.whl |
|---|---|
| Size | 70.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc5751882cfa8f0b0329f03a5d47163bd22ac10ba10e26f5e6d6c6be36af893e
|
|
BLAKE2b-256 checksum How to use checksums |
435e519c9fc3796c956bb5d14f4091c9eb1147abbe45ee552a050a957d6807b0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.10.12
|
Security for boosteros 1.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.