# 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](https://github.com/Akseli-Ilmanen/ethograph/issues) 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:

```bash
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 {doc}`../getting_started/installation` for details on setting up a virtual
environment and installing uv.