FreeMoCap 安装配置完整指南：从零跑通开源无标记动作捕捉系统

FreeMoCap 安装配置完整指南从零跑通开源无标记动作捕捉系统【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocapFreeMoCap 是一个免费开源、不挑硬件的无标记动作捕捉系统motion capture用多台普通摄像头拍人就能还原出 3D 骨骼运动数据适合科研、教学和低成本动捕数据采集。不想买商业动捕设备又想自己搭一套可用环境的跟着下面做就行。安装环境怎么检查先备好 Python 3.11、uv 和 Node.js动手前先确认这几样缺一样后面都会卡住Python ≥ 3.11项目硬性要求 3.11 及以上pyproject.toml 中声明了requires-python 3.11终端执行python --version看一下uv一个速度很快的 Python 环境与包管理工具。这个仓库的依赖skellytracker、skellycam 等是从一组 git 仓库拉取的官方说明里明确写了 conda pip install -e .这条路走不通必须用 uvGit用来克隆仓库Node.js npmGUI 是 React Electron 写的跑前端要它NVIDIA GPU可选Windows/Linux 上有 NVIDIA 显卡会默认装 GPU 加速版推理没有也能跑走 CPU 版即可最小路径跑起来克隆仓库并启动 Python 后端 后端是全部安装的核心一共 5 条命令。克隆仓库git clone https://gitcode.com/GitHub_Trending/fr/freemocap它把源码拉到本地看到一堆文件包括freemocap/和freemocap-ui/两个目录即成功。进入项目根目录cd freemocap创建虚拟环境一个独立的 Python 依赖沙盒不污染系统环境uv venv应看到Using Python 3.11.x和.venv创建成功的提示。安装全部依赖uv sync这一步耗时最长要拉取多个 git 依赖并安装推理引擎。它会自动按平台选择版本Windows/Linux 装 NVIDIA GPU 加速版macOS 装 CPU 版。如果你的 Windows/Linux 机器没有受支持的显卡改用 CPU 版uv sync --no-default-groups --group cpu。启动 Python 服务端它是 FastAPI uvicorn 组成的 HTTP/WebSocket 服务前端的摄像头、标定、动捕能力都挂在它上面uv run python freemocap/__main__.py终端会打印一行FREEMOCAP_PORT53117之类的端口哨兵sentinel即端口号公告服务开始监听本地端口并保持运行。GUI 怎么启动装前端依赖并弹出界面️ 后端开着别关再开一个终端同样进入项目根目录后进入前端目录并安装依赖npm 读 freemocap-ui/package.json 里的依赖清单cd freemocap-ui npm install看到added xxx packages无报错即完成。启动 GUInpm run dev这会同时拉起 Vite 开发服务和 Electron 桌面窗口应弹出一个 FreeMoCap 界面窗口它默认连接本机后端默认端口 53117见 freemocap-ui/src/constants/server-urls.ts。验证成功以及失败时怎么办成功标志有两个都满足才算装好后端终端稳定打印出FREEMOCAP_PORT端口且没有异常堆栈GUI 窗口弹出后浏览器访问http://localhost:53117/health能返回正常响应这是服务自带的健康检查接口最常见的两种失败uv sync报 Python 版本不满足说明系统里的 Python 低于 3.11。装一个新版 Python 后删除.venv重新uv venv uv sync即可没有显卡却装了 CUDA 版启动报错或推理极慢在 Windows/Linux 上删掉虚拟环境用 CPU 版重装uv sync --no-default-groups --group cpu。另外若端口被占服务会自动顺延尝试下一个可用端口以终端实际打印的端口号为准新手常问的三个问题Q没有 NVIDIA 显卡能正常用吗能。GPU 只是加速推理CPU 版功能相同只是速度受限适合先跑通流程。Q怎么确认前后端连上了看后端端口哨兵输出再用浏览器开/health接口GUI 里连接失败通常就是后端没起或端口对不上。Q动捕前需要的标定板CharUco board带棋盘的印刷图案用来求相机参数在哪仓库里就有可打印的 ChArUco 标定板素材GUI 的标定设置里也有对应尺寸选项打印出来按界面提示拍摄即可到这里安装已经跑通下一步就是接入摄像头、完成一次相机标定并录下第一段动捕数据具体流程可以看 freemocap-docs/docs/guides/ 里的相机搭建与后处理指南。【免费下载链接】freemocapFree Motion Capture for Everyone ✨项目地址: https://gitcode.com/GitHub_Trending/fr/freemocap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考