We are happy to accept your contributions to make AymurAI
better and more awesome! To avoid unnecessary work on either
side, please stick to the following process:
- Check if there is already an issue for your concern.
- If there is not, open a new one to start a discussion. We hate to close finished PRs!
- If we decide your concern needs code changes, we would be happy to accept a pull request. Please consider the commit guidelines below.
In case you just want to help out and don't know where to start, issues with "help wanted" label are good for first-time contributors.
For contributors looking to get deeper into the API we suggest cloning the repository. Nearly all classes and methods are documented, so finding your way around the code should hopefully be easy.
You can use the provided devcontainer
load all the tools and packages needed. This can be done directly from Visual Studio Code.
You can check the devcontainer documentation for more information.
If you want just check the notebooks and tutorials you can use the jupyterlab
docker image. To run the image in gpu
mode run:
make jupyter-run
alternatively you can run in cpu
mode with:
make jupyter-run-cpu
create a python environment of your preference and run:
pip install src/aymurai
You may need to install redis or run it in a docker container. You can use the following command to run it in a docker container:
make redis-run
After installing the dependencies, install pre-commit
hooks via:
pre-commit install
This will automatically run code formatters black and isort for each git commit. Also it will clear all outputs from the notebooks. If you want to more information about why we do this, please refer to the data security section.
To ensure a standardized code style we use the formatter black and for standardizing imports we use isort. If your code is not formatted properly, the tests will fail.
If you set up pre-commit hooks, every git commit will automatically run these formatters. Otherwise you can also manually run them, or let your IDE run them on every file save.
Running from the command line works via black src/aymurai/ && isort src/aymurai/
in the repository root folder.