mrkeyoor.com_
Sun 27 Sept 17:35 UTC
AI Toolsevaluationupdated 27 Sept 2026

freemocap review

FreeMoCap turns ordinary cameras into a markerless human motion-capture system for research, teaching, and animation. It records synchronized video, estimates body motion, reconstructs movement in 3D, and can export the result for tools such as Blender.

Verdict

Our FreeMoCap build took 1 second, but 9 of 44 tests never collected because libGL.so.1 was missing, and pip-audit found 4 known vulnerabilities. It is a serious option for low-cost experiments, classes, and animation trials if you can validate each capture and tolerate an alpha release. Do not use current 2.0 output as research-grade distance data until the documented scaling error is resolved and your own calibration check passes.

We ran it

Lab card: what happened when we ran freemocapScreenshot of freemocap (freemocap.org)
Install✓ · 75s114 packages · 1276 MB
Build✓ · 1s
Tests✗ · 8s35 passed · 0 failed · 9 errors of 44 (pytest)
Known vulns4(pip-audit)
Repo830 files~69,156 lines of source · 7.4 MB · 7 CI workflows

Answers from our run

Does freemocap build from source?

Dependencies installed in 75 seconds (114 packages), and the build succeeded in 1 seconds. We cloned commit 75c8acc into a clean Debian container with 3 CPUs and no project-specific setup.

Do freemocap's tests pass?

Yes: 35 of 44 passed when we ran the project's own test command (pytest), with 9 collection errors. Some failures need services or credentials a bare container does not have.

Does freemocap have known vulnerabilities in its dependencies?

pip-audit flagged 4 known advisories in the dependency tree at the time of our run.

Who should not use freemocap?

Researchers who need dependable physical scale today: the v2.0.0-alpha.25 notes warn that skeleton reconstructions may be off by roughly 10%.

What are the alternatives to freemocap?

OpenPose, MMPose, DeepLabCut. Our FreeMoCap build took 1 second, but 9 of 44 tests never collected because `libGL.

Setup2/5Installers exist, but source setup missed libGL and spans two stacks
Docs3/5Quickstarts are useful, though branches and 1.x versus 2.0 blur
Community5/510,322 stars with current pushes, releases, issues, and PRs
Maturity2/5The latest package is alpha and warns of data-affecting bugs

Who it’s for

Researchers and teachers who need inspectable motion data without buying a commercial marker-based system.
Animators willing to calibrate cameras and clean up results before using them in Blender.
Python and TypeScript contributors working on pose tracking, triangulation, calibration, or capture interfaces.
Labs that can validate scale and tracking accuracy against their own protocol before collecting study data.

Who it’s NOT for

Researchers who need dependable physical scale today: the v2.0.0-alpha.25 notes warn that skeleton reconstructions may be off by roughly 10%.
Intel Mac users: the current alpha says its MediaPipe and RTMPose models do not support that platform.
Teams that need a stable 2.0 migration: the release notes call the package alpha, warn of data-affecting bugs, and say 1.x recording compatibility is not fully verified.
Linux users who cannot troubleshoot packaged-library conflicts: open alpha.21 reports cover AppImage startup failures from a stale mount path and an older bundled libstdc++.so.6.
Closed-source distributors unwilling to meet AGPL-3.0 terms or arrange a separate license with the project.

Setup reality

Our sandbox installed 114 Python packages in 75 seconds and used 1,276 MB. The build passed in 1 second. Pytest then exited 1 after 8 seconds: 35 tests passed, 0 failed, and 9 hit collection or setup errors because libGL.so.1 was missing. The README's source steps do not name that system library.

Source use requires uv, private Git dependencies named by the README, and separate Node setup for the React and Electron interface. Windows and Linux users choose CUDA or CPU dependency groups; the 2.0 alpha also provides platform installers. Camera calibration and access to the intended cameras remain part of a useful run.

The 7.4 MB checkout had 830 files and about 69,156 source lines. Our scan found 7 CI workflows, no Dockerfile, and no root tests directory. Pip-audit reported 4 known vulnerabilities in the installed environment; the supplied result does not identify their packages or severity.

Ordinary cameras can produce a 3D skeleton

FreeMoCap is built around a useful compromise. Instead of reflective markers, dedicated suits, and proprietary capture hardware, it uses video from ordinary cameras plus pose-estimation models. The system synchronizes views, detects a person, triangulates tracked points into 3D coordinates, and prepares data for analysis or animation. That opens motion capture to classrooms and small labs, but the output still depends on camera placement, calibration, visibility, and the selected tracker.

Version 2.0 is a Python server paired with a React and Electron interface. The development instructions start the server on port 8005 and run the desktop interface from a second terminal. Source dependencies include FreeMoCap's skellytracker and skellycam projects, pulled through uv; the README says a normal editable pip install will not work for this checkout. Packaged releases are the easier route for users who only want to record.

A 1,276 MB environment still missed a graphics library

Our fresh Debian sandbox installed 114 Python packages in 75 seconds, consuming 1,276 MB. That is a substantial environment beside a 7.4 MB checkout. The build itself completed in 1 second, but that result should be read narrowly. It does not cover camera calibration, the Electron interface, a CUDA tracker, or the quality of a reconstructed movement. Those need the operating system and hardware path you intend to use.

The source instructions split further by platform. Windows and Linux default to an NVIDIA-accelerated skellytracker group, with an explicit CPU alternative for unsupported hardware. macOS uses the CPU path. The latest release provides Windows, Apple silicon macOS, and x64 Linux installers, including large CUDA builds hosted away from GitHub because some assets exceed its 2 GB limit. Intel Macs are not supported by the current pose models.

What happened when we ran it

Our run used commit 75c8acc, 3 CPUs, 8 GB of RAM, Python 3.12, and an unprivileged container. Pytest ended with exit code 1 after 8 seconds. It reported 35 passing tests and no failed assertions, but 9 modules could not complete collection or setup. The summary covered 44 discovered outcomes and listed 6 warnings.

Every listed error shared one concrete message: libGL.so.1 could not be opened because the file was absent. The affected areas included calibration math, HTTP routers, pipelines, pubsub, rigid-body work, center of mass, and triangulation. We should not infer a code defect from that log. The useful finding is that the README's Python source setup did not prepare this clean Debian image with a graphics system library required during test imports.

Pip-audit also reported 4 known vulnerabilities in the installed Python environment. The supplied audit result does not name the packages, advisory IDs, or severities, so it cannot support a stronger risk claim. The repository scan found 7 CI workflow files, no Dockerfile, and no top-level tests directory, although tests exist under the package path and 35 of them ran successfully in our sandbox.

The current alpha warns of a 10% scale error

Release v2.0.0-alpha.25 was published on September 24, 2026. It fixes CPU-only startup, Linux server startup, Blender export options, and hand detection. Its own warning says alpha means errors, missing features, rough edges, and possible data-affecting bugs. The most consequential known problem is a skeleton reconstruction scale error of roughly 10%, which the maintainers connect to the current calibration or triangulation pipeline.

That warning changes the buying decision. An animator can rescale or clean a take after visual inspection. A researcher measuring reach, gait, or joint trajectories cannot quietly accept a 10% distance error. FreeMoCap can still be part of a study, but the lab needs a known-length object, a repeatable calibration procedure, and an acceptance threshold defined before participants arrive. The repository does not make that validation disappear by calling the system research-grade.

Linux packages and 1.x data need careful trials

Two open reports describe alpha.21 AppImage failures on an Arch-based distribution. One stores a temporary mount path and fails on the next launch; another ships an older libstdc++.so.6 that conflicts with the system audio stack and prevents camera and microphone detection. They concern an older alpha, so they do not prove alpha.25 fails the same way. Their open status is enough reason to test two launches and actual camera detection on the target Linux image.

The 2.0 release notes also recommend keeping a 1.x environment while the stable version is unfinished. Recordings can be reprocessed across versions, but full data compatibility has not been verified. A serious lab should preserve raw videos, calibration files, application versions, model choices, and exported data together. That record matters more than whether the 1-second build step stays green.

Current activity is high, while stability is deliberately low

GitHub recorded a push on September 27, 2026, three days after the alpha.25 release. The project had 10,322 stars and 167 open issues and pull requests when fetched. Recent merged work covers tests, installers, Blender output, hand detection, and multi-camera synchronization. The combined open count is not a defect count, but the dated push and release show active maintenance.

FreeMoCap earns attention because it packages capture, tracking, reconstruction, and export into something a small lab can inspect and modify. The same package is still an alpha with a documented scale problem, platform-specific installer reports, 4 audited dependency advisories, and a source test suite that needs more system preparation than the README states. Use it for exploration now. Put numbers from it into a paper only after your own measurement protocol proves they are trustworthy.

Alternatives

ProjectWhat it isPick it when
OpenPoseA body, face, hand, and foot keypoint detector rather than a complete capture workstation.pick this instead when keypoint detection is the main requirement and you will build the recording and 3D workflow yourself.
MMPoseA pose-estimation toolbox with many model families, datasets, and training recipes.pick this instead when model research and custom training matter more than an end-user multi-camera application.
DeepLabCutA markerless pose system for user-defined features on animals and humans.pick this instead when you need to label and train for animal behavior or custom landmarks.

What people are saying

  1. [github-trending] freemocap/freemocap

Sources

  1. FreeMoCap repository and README
  2. FreeMoCap v2.0.0-alpha.25 release notes
  3. Issue 820: 2.0 calibration and scaling
  4. Issue 875: Linux AppImage library conflict
  5. Issue 876: Linux AppImage stale server path

More ai tools reviews

ComfyUI-H3VAE_TRT · reverify · gallery · undress-service · khazix-skills · nobodywho · the whole board →