Skip to main content

Booster OS

Booster Robotics 机器人操作系统核心 SDK
旨在为人形机器人提供统一、高效、易用的开发接口。

Python Version License

💡 为什么选择 Booster OS?

  • 统一抽象:一套代码适配多种机器人硬件(Booster K1, Unitree 等)。
  • 感控一体:原生集成视觉检测(Detection)与运动控制。
  • 异步驱动:基于任务句柄(TaskHandle)的非阻塞控制架构。

📖 文档索引

如果你需要深入了解某个模块,请查阅以下专门文档:


🛠️ 安装

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

# 包含视觉与大脑推理功能(默认包含 CPU 版 ONNX Runtime)
pip install "boosteros[brain]"

# 机器人端 GPU / QNN 加速:在安装 brain 之后直接安装对应硬件平台的加速 wheel(自动无缝替换 CPU 版)
# pip install /path/to/onnxruntime-<version>+<hardware>-*.whl

🚀 核心组件概览

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.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for boosteros 1.2.4
File Size Uploaded Provenance Actions
boosteros-1.2.4.tar.gz 34.5 MB Without provenance Details for boosteros-1.2.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for boosteros 1.2.4
File Interpreter ABI Platform Actions
boosteros-1.2.4-py3-none-any.whl Python 3 none any Details for boosteros-1.2.4-py3-none-any.whl

Total release size: 68.2 MB

Release files / boosteros-1.2.4.tar.gz

Download URL boosteros-1.2.4.tar.gz
Size 34.5 MB
Tags Source
SHA-256 checksum
How to use checksums
0a4156b5dc150229aefe41092b91a313e38e7e4e3cc006bdbfc57d7008294020
BLAKE2b-256 checksum
How to use checksums
211a1a0d3a9bf90e137a2a3026f1beb5cce83eca0441b1c7a2bc6c0ce85357bc
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.4-py3-none-any.whl

Download URL boosteros-1.2.4-py3-none-any.whl
Size 33.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ca6ce9c2e2a637ec62ffdaee23efeff68fac22b5e312fd6b64cd3ba05af55ca3
BLAKE2b-256 checksum
How to use checksums
85f9a878f00e4652154c8e94fedb93cc4227ebce5b1eac251b5a223a1a070463
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.4

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page