安装

系统要求

• Python 3.10+
• pip（或 uv 以获得更快的安装速度）

从源码安装

状态： threewe SDK 正在积极开发中。pip install threewe 尚未在 PyPI 上发布。请从源码安装：

git clone https://github.com/telleroutlook/3we-robot-platform.git
cd 3we-robot-platform
pip install -e sdk/threewe/

验证

mock 后端可以立即工作——无需 ROS2 或 Gazebo：

import asyncio
from threewe import Robot

async def main():
    async with Robot(backend="mock") as robot:
        image = robot.get_image()
        await robot.move_to(x=2.0, y=1.0)
        pose = robot.get_pose()
        print(f"Robot at: ({pose.x:.2f}, {pose.y:.2f})")

asyncio.run(main())

你是谁？

如果你是…	从这里开始
AI/ML 研究员	第一个机器人 — Gymnasium 环境、VLM/VLA、轨迹记录
机器人学学生	组装指南 — 从 PCB 到 Python 的全栈
RL 从业者	仿真 — gym.make("3we/Navigation-v1")
硬件构建者	物料清单 — 开放 BOM，CERN-OHL-P 许可

下一步

• 第一个机器人 — 运行你的第一次导航
• 仿真 — 探索 Gazebo 和 Isaac Sim 后端
• 组装指南 — 构建物理机器人