FF SDK 是面向开发者的统一机器人控制开发包。人形与四足、真机与仿真,
全部通过同一套 async Python API 控制 ——
运动、状态遥测、语音、视觉、表情,一次学习,处处运行。
全尺寸人形机器人。能力覆盖最全的平台:运动 + 状态 + 语音 + 视觉 + 表情全部可用,机械臂 / 导航 / 人脸考勤持续完善中。
紧凑人形机器人。预置动作 / 上传动作作品播放与状态遥测可用,配合动作工作室生态可播放自制舞蹈动作包。
四足机器狗产品线(点足 / 轮足 / EDU / Ultra)。运动控制与全套状态遥测真机验证,含特技动作与关节级遥测,自包含 wheel 零额外依赖。
紧凑型四足机器人。运动 + 状态 + 上百个扩展动作(鞠躬 / 招手 / 舞蹈 / 表情),步态与运动参数深度可调,专属 session.navi.* 命名空间。
import asyncio, ff_sdk
async def main():
# 换一个 target 前缀,就是换一台机器人 —— API 不变
robot = await ff_sdk.connect("D1-DEMO") # Aegis 四足
# robot = await ff_sdk.connect("A2-DEMO") # Futurist 人形
# robot = await ff_sdk.connect("X2-DEMO") # Master 人形
# robot = await ff_sdk.connect("NV-DEMO") # Navi 四足
# robot = await ff_sdk.connect("mujoco://d1") # 物理仿真,免真机
await robot.motion.stand() # 站立
await robot.motion.cmd_vel(linear=0.3) # 前进 0.3 m/s
await asyncio.sleep(2)
await robot.motion.stop()
battery = await robot.state.battery() # 读电量
print(f"电量 {battery.percent:.0%}")
await robot.close()
asyncio.run(main())
所有功能按能力域组织:robot.motion / robot.state / robot.audio…… 平台不支持的能力会明确抛出 CapabilityNotSupported,绝不假装成功。
内建 e_stop() 紧急停止、diagnose() 健康体检、状态机保护。dry-run 模式让你在没有真机时也能完整跑通业务逻辑。
mujoco:// 物理仿真与真机共享同一套 API。先在仿真里把逻辑调对,再连真机 —— 示例库提供 sim-to-real 迁移菜谱。
每个平台的 devkit 一个 zip 全装下:wheel(机器人 aarch64 + 开发机 x86_64)、文档、可运行示例。不需要安装任何第三方厂商 SDK。