Skip to content

Open source & building ​

RodentLimb is open source under the GNU AGPL-3.0. The app, every analysis and this manual are in one public repository:

github.com/seesaw-earth/RodentLimb

Where things are in the code ​

TopicManual pageSource file
Pose inference, decoding, video readingPose modelPoseEngine.swift, PoseDecoder.swift
Cleaning, body length, signal toolsPose modelPoseSeries.swift
Tail suspensionTail suspensionTSTAnalyzer.swift
Cylinder testCylinder testCylinderAnalyzer.swift
GaitGait analysisGaitAnalyzer.swift
Parameters and defaultsParametersAnalysisModels.swift
Exports and methods textFiles & exportsExporter.swift
Validation scriptsValidationTools/validation/
English and Chinese text—L("English", "中文") calls in every view; L10n.swift

Build from source ​

You need a Mac with Xcode 16 or later and an iPhone with iOS 17 or later. There are no third-party Swift packages.

bash
git clone https://github.com/seesaw-earth/RodentLimb.git
cd RodentLimb
python3 Tools/install_model.py --v2 /path/to/CylinderMousePoseV2.mlpackage.zip
open RodentLimb.xcodeproj

In Xcode, choose your signing team and run on an iPhone. The model weights are not in the repository; see MODEL_PROVENANCE.md.

Build this manual ​

bash
npm install
npm run docs:dev     # live preview at http://localhost:5173/RodentLimb/
npm run docs:build   # static site in docs/.vitepress/dist

Pushing changes under docs/ to main publishes the site through GitHub Actions.