Contributing

Contributions are welcome! Whether it’s bug reports, feature requests, or pull requests — all help is appreciated.

Reporting issues

Open an issue on the GitHub repository with a clear description of the problem and steps to reproduce it. Please:

1. In the top bar, Help ▸ Print current state. Share this message along with your error.

2. If you have data loading problems, send some sample data to akseli.ilmanen@gmail.com, so I can test it myself.

Development installation

To install ethograph in editable mode with all optional dependencies and development tools:

git clone https://github.com/Akseli-Ilmanen/ethograph
cd ethograph
uv pip install --torch-backend=auto torch torchvision
uv pip install -e ".[gui,audio,model,dandi,dev,docs]"

See Installation for details on setting up a virtual environment and installing uv.