tutorials/
: Contains tutorial notebooks and related materials.requirements.txt
: Lists dependencies required for the project.
The structure of each tutorial is as follows:
├───tutorial.ipynb
├───config.py
├───configs
│ ├───base.yml
│ ├───**.yml
├───model.py
├───models
│ ├───**.pt
├───data
│ ├───**.csv
│ ├───**.**
├───images
│ ├───**.png
│ ├───**.jpg
├───**.py
-
Fork the repository.
-
Create a new branch for your tutorial or bug fix:
git checkout -b my-branch
-
Make your changes and commit them with clear messages:
git commit -m "Add function ... to simplify tutorial ... content"
-
Push your branch to your forked repository:
git push origin my-tutorial-branch
-
Open a pull request to the main repository.
Please ensure your contributions adhere to the repository's coding standards and include appropriate documentation.
To build the book in development, assuming that the working directory is the project's folder, please call:
jupyter-book build .
This repository uses pre-commit hooks to ensure code quality and consistency. To set up pre-commit hooks locally, follow these steps:
-
Install the
pre-commit
package if you haven't already:pip install pre-commit
-
Install the hooks defined in the
.pre-commit-config.yaml
file:pre-commit install
-
Run the hooks manually on all files (optional):
pre-commit run --all-files
Pre-commit hooks will now run automatically on every commit to check and format your code.