README.md

May 16, 2026 · View on GitHub

 Stera SDK

by FPV Labs (fpvlabs.ai)

PyPI Python License

Scan to get the iOS app

stera-sdk is the Python SDK behind Stera (website · iOS app).

Load MCAP recordings, run swappable hand, face, and skeleton models behind one schema, and visualize or export clean episodes, ready for embodied AI, VLAs, and world models.

Quick Start

import stera
from stera.data import MCAPReader
from stera.models import HandTracker, FaceBlurrer
from stera.viz import Visualizer
from stera.processing import MeshRefiner
from stera.eval import Evaluate

session = MCAPReader("recording.mcap")
hands   = HandTracker(model="mediapipe")
blur    = FaceBlurrer(model="mediapipe")
viz     = Visualizer(session, map_3d="auto")

for frame in session.frames():
    blurred = blur.blur(frame)
    poses   = hands.detect_hands(frame)
    session.add_rgb_frame(frame.index, blurred)
    session.add_hand_pose(frame.index, poses)
    viz.log_frame(frame, hands=poses)

mesh = MeshRefiner(session).refine()           # clean + densify + colorize
session.export("episodes/run_01", visualizer=viz, mesh=mesh)
Evaluate(session).show()                       # interactive HTML QC report

Stera SDK

Getting started

pip install "stera-sdk[all]"

Documentation

License

Apache 2.0 © FPV Labs