Welcome to CSGHub and thank you for your interest in contributing to this project!
CSGHub is an open-source and trusted asset management platform for large language models (LLMs). It aims to assist users in governing assets (datasets, model files, code and etc.) involved in the lifecycle of LLMs. CSGHub provides functionality similar to a private version of Hugging Face, with asset management capabilities comparable to GitLab for source code, OpenStack Glance for virtual machine images, Harbor for container images, and Sonatype Nexus for artifacts.
This project follows the "Fork & Pull Request" workflow for contributions. Direct pushes to the main repository are restricted to maintainers only.
- Fork this repository (https://github.com/OpenCSGs/csghub) to your GitHub account.
- Make changes in your forked repository.
- Create a new branch in your forked repository to save your updates, preferably based on the
main
branch. - Implement your updates in the new branch.
- Open a Pull Request (PR) targeting the
main
branch of the original repository. - Work with maintainers through the review process.
- Once approved, your PR will be merged into
main
.
To ensure high-quality contributions:
- Maintain consistent code style.
- Include tests for new features or improvements.
- Provide clear, well-written documentation that other developers can easily follow.
Found a bug or have a suggestion? Open an issue on our Issues page.
When creating an issue:
- Be specific about the issue - "XY doesn't work" isn't helpful.
- Include minimal code example that demonstrates the issue.
- For large code blocks or logs, use
<details>
and</details>
tags to keep issues readable. Learn more about content collapsing here.
Check our labels page to understand how we categorize issues and PRs.
You can develop CSGHub using either Docker Compose or set up a Local Environment.
We appreciate your interest in contributing to CSGHub and look forward to your contributions!