[Hacktoberfest 2024] How to contribute

[peterschmidt85]

Hacktoberfest is a great chance to contribute to your favorite open-source projects! Join us in improving dstack throughout October, starting on the 1st.

Note

☁️ Every contributor whose PR is merged will receive GPU credits to use with dstack Sky for AI development! Read below for details.

How do I get started?

Warning

Before you start, ensure you understand dstack and have tried it using your own cloud account or an on-prem machine with dstack's SSH fleets. This step is essential for any contribution; skipping it makes contributions meaningless.

1. Join Discord
2. In case you haven't used dstack before, ensure to install it, and give it a try. In case you have questions about dstack, make sure to ask them in Discord.
3. Read CONTRIBUTING.md
4. Ensure you've set up the development environment and know how to run dstack from sources. In case you have questions about dstack, make sure to ask them in Discord.
5. Look at the list of some of the issues you can help with below. Pick an issue. Comment the issue with any questions or suggestions. Ensure you understand how it can be implemented.

Issues

Minor

• Handle KeyboardInterrupt in CLI when getting run plan #1626
• [UX] For dev-environments, print the prompt after running theinit commands #1471
• Detect the default Python version in CLI, not in dstack-server #1461
• [Minor] Rename the default Conda environment from workflow to base #1385
• Rename the folder where dstack uploads the repo from /workflow to /repo (and document it) #1379
• [Bug]: Permission denied: /Users/riwaj/.ssh/config.lock #1205
• Support JetBrains Fleet as an alternative IDE for dev environments #821
• [Examples] Add vLLM example #1623
• [Examples] Add NVIDIA Nim example #1748
• [Examples] Add GitHub Actions example #1749
• [Examples] Add FLUX example #1750
• [Examples] Add TGI example #1751

Major

• [Feature]: Support the Capacity Blocks for ML feature for AWS #1155
• [Feature]: Support resources with the gateway configuration type #1664
• Use all available RunPod regions by default #1573
• [Feature]: Support H100 with Azure #1239
• [Examples] Add Airflow example #1752
• [Examples] Add TensorRT-LLM example (end-to-end) #1753
• [Examples] An example of fune-tuning with torchtune #1787

Advanced

• Support FluidStack backend #1747
• Implement a terraform provider #1495

Can't find an issue?

Feel free to create your own issues to improve dstack—whether it’s usability, new features, better docs, or cool examples.

With your help, we'll be adding more issues to the list each week.

Bounties

• Minor issue – $15
• Major issue – $100
• Advanced issue – $500

Warning

Bounties apply only to quality contributions reviewed and merged by the project's maintainers. If you're interested in joining the reviewer team, please reach out.

[bikash119]

Created a new issue #1759. Will raise PR soon.