# 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 `Navigation & Help`, click on `Print for debugging`. 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 -e ".[all,dev,docs]"
```

See {doc}`../getting_started/installation` for details on setting up a virtual
environment and installing uv.