Dev Container notes

This configuration uses Python 3.12 on Debian Bookworm with runtime packages commonly needed for OpenCV (libglib2.0-0, libgl1). After the container is created, dependencies are installed from requirements.txt, the package is installed editable, requirements-dev.txt is applied, Ruff is installed for CI parity, and pre-commit hooks are installed.

Working with .tmd files

The repository includes tracked .tmd fixtures at smoke-test paths (examples/gelsight/…, examples/v1/Dime.tmd, examples/v2/Dime.tmd, and tests/fixtures/gelsight_wear_volume_second_frame.tmd). Other .tmd files under examples/ are gitignored—mount or copy your own captures there when needed (or use TMDTerrain / the terrain CLI).

Useful commands

• Tests: pytest
• Lint (matches CI): ruff check .
• CLI: tmd-process --help, tmd-wear --help, or python tmd_cli.py --help
• Docs: mkdocs serve -a 0.0.0.0:8000 (port 8000 is forwarded by default)

Python 3.8–3.12 is validated in GitHub Actions; the container uses a single modern interpreter for day-to-day work.