外观
Skip to content
franka_rosfranka/frankarobotics-franka-ros2025-10-24franka_ros2franka/frankarobotics-franka-ros222 天前franka_descriptionfranka/frankarobotics-franka-description2 个月前the_reference_platformfranka/frankarobotics-the-reference-platform2023-05-22labsfranka/frankarobotics-labs1 个月前franka_spacemousefranka/frankarobotics-franka-spacemouse2025-07-18
libfranka
libfranka
frankarobotics 在 GitHub 开源的算法库，主要语言 C++。 C++ client library to control Franka robots in real-time
概述
这个开发工具的核心职责、所属技术栈与硬件生态定位。
libfranka是Franka Robotics开源的机器人控制算法库，核心开发语言为C++，定位为面向Franka机器人的底层控制客户端库，核心功能为提供机器人实时控制能力，支持开发者直接调用接口完成关节级、笛卡尔空间的运动指令下发与状态反馈获取，接口设计轻量化且符合实时系统调度要求。
该库适配Franka Research 3、Franka FR3 Duo两款研究型七轴协作机器人，处于机器人软件栈L3层级，可直接对接机器人控制器原生通信协议，开发者可通过C++项目链接编译该库完成集成，也可搭配ROS/ROS2控制栈、运动规划算法库实现上层应用开发，支持实时力控、拖拽示教等场景部署。
关键工程信息
工具分类、开发语言、GitHub 社区活跃度与环境要求。
- 工具类型
- 算法库
- 所属品牌 / 组织
- 开发语言
- c++
- 技术栈层级
- L3 本体 SDK 与控制
- 适配机型数
- 2 款
- 统计日期
- 2026-10-13
- 环境注意事项
- 不支持Windows系统原生编译，仅可通过WSL2模拟环境使用且实时性无保障低于0.13.0的旧版本不兼容Franka FR3 Duo机器人控制器固件
快速接入与环境要求
源码克隆、构建方式、已验证系统环境与版本更新记录。
源码拉取与构建参考
git clone https://github.com/frankarobotics/libfranka.git
cd libfranka
# CMake 构建工程
mkdir -p build && cd build
cmake .. && make -j$(nproc)推荐运行环境与版本 1
| 版本 / 分支 | 验证环境 | 接入说明 |
|---|---|---|
| main / 最新稳定分支，建议搭配对应ROS 2 Humble/ROS Noetic适配的发布版本 | Ubuntu 22.04 LTS + GCC 9+ / 搭配ROS 2 Humble或Ubuntu 20.04 + ROS Noetic | 克隆仓库后用CMake编译，安装依赖后通过link_libraries(franka)链接到自有C++项目即可调用控制接口 |
关联实操教程与排障记录
教程 / 实测 / 排障 6
百科FR3 Duo 开发百科：双臂 Franka 原型机的 ROS 2、FCI 与仿真入口教程手眼标定与多传感器时空同步实操手册：RealSense / ZED 2i / Livox Mid-360 与机械臂/四足联合标定教程Franka FR3：franka_ros2 安装、FCI 实时内核与 MoveIt 2 规划教程openpi：用 DROID 策略在 Franka/DROID 上做远程推理（policy server + client）教程Physical Intelligence openpi（π0 / π0-FAST）自有遥操作数据微调与真机推理指南踩坑libfranka报错unable to set realtime scheduling: Oper。
适配与兼容机型
支持接入该 SDK、ROS 驱动或仿真资产的机器人本体。
同厂商与同类工具
同一厂商开源的配套仓库或同技术栈开发工具。
franka_rosfranka/frankarobotics-franka-ros2025-10-24franka_ros2franka/frankarobotics-franka-ros222 天前franka_descriptionfranka/frankarobotics-franka-description2 个月前the_reference_platformfranka/frankarobotics-the-reference-platform2023-05-22labsfranka/frankarobotics-labs1 个月前franka_spacemousefranka/frankarobotics-franka-spacemouse2025-07-18来源
本页事实对应的公开页面，以原文为准。
- GitHub frankarobotics/libfranka访问 2026-10-13