Thank you for your interest in contributing to Genesis! We welcome contributions from everyone. Please take a moment to review this guide to ensure a smooth collaboration.
- Reporting Bugs
- Suggesting Features
- Submitting Code Changes
- Reviewing and Merging
- Questions and Discussions
-
Before reporting a bug, please search through existing issues to check if it has already been reported.
-
If the issue hasn't been reported yet, please use our issue templates to provide as much detail as possible in your report.
**Description** A clear and concise description of what the bug is. **To Reproduce** Example code or commands to reproduce the bug. **Expected behavior** A clear and concise description of what you expected to happen. **Screenshots** If applicable, add screenshots to help explain your problem. **Environment:** - OS: [e.g., Linux, macOS] - GPU/CPU: [e.g., A100, RTX 4090, M3pro] **Additional context** Add any other context about the problem here.
- If you have a feature idea, please create an issue labeled
enhancement
. - In the created issue, please provide context, expected outcomes, and potential.
-
We use the
pre-commit
configuration to automatically clean up code before committing. Install and runpre-commit
as follows:-
Install
pre-commit
:pip install pre-commit
-
Install hooks from the configuration file:
pre-commit install
After this,
pre-commit
will automatically check and clean up code whenever you make a commit.
-
-
(Optional) You can run CI tests locally to ensure you pass the online CI checks.
python -m unittest discover tests
-
In the title of your Pull Request, please include [BUG FIX], [FEATURE] or [MISC] to indicate the purpose.
-
In the description, please provide example code or commands for testing.
- PRs require at least one approval before merging.
- Automated checks (e.g., CI tests) must pass.
- Use
Squash and Merge
for a clean commit history.
- Use Discussions for open-ended topics.
We appreciate your contributions and look forward to collaborating with you!
Thank you,
Genesis Maintainers