Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
91 lines (65 loc) · 2.77 KB

CONTRIBUTING.md

File metadata and controls

91 lines (65 loc) · 2.77 KB

Contributing to Agentex

Thank you for considering contributing to Agentex! Contributions make the open source community amazing and help improve the project for everyone. Any contributions you make are greatly appreciated.

We welcome bug fixes, enhancements, documentation improvements, tests, and more.

Development Environment Setup

To set up your development environment for Agentex, please refer to the README.md for up-to-date instructions.

How to Contribute

  1. Fork the repository.
  2. Clone your fork: 
    git clone https://github.com/<your-username>/agentex.git
cd agentex
  3. Set the original repo as upstream (recommended): 
    git remote add upstream https://github.com/scaleapi/agentex.git
  4. Create a new branch for your feature or bugfix: 
    git checkout -b my-feature-or-bugfix
  5. Make your changes.
    Follow project coding style and conventions.
  6. Test your changes: 
    make test
    Run linter/formatter as required: 
    make lint
  7. Commit your changes (see commit message guidelines below).
  8. Push to your fork: 
    git push origin my-feature-or-bugfix
  9. Open a Pull Request against main with a clear description.

Commit and PR Title Guidelines

This project enforces Conventional Commits on PR titles. A CI check will validate your PR title before it can be merged.

Format: type: description or type(scope): description

Allowed types: feat, fix, docs, style, refactor, test, chore, ci, build, perf, revert

Examples:

feat: add user authentication middleware
fix(api): handle empty request body gracefully
docs: update contributing guidelines
chore: bump dependency versions

General commit message best practices

  • Use the imperative mood (e.g., “Add feature” not “Added feature”).
  • Keep the subject line under 72 characters.
  • Use the body to explain what and why vs. how (if needed).
  • Reference relevant issues/PRs (e.g., Fixes #123).

For more, see: Chris Beams' guide to writing great commit messages.

Contributing to the Python SDK

If you want to contribute to the Agentex Python SDK, please use the scale-agentex-python repository and follow its contributing guidelines.

Code of Conduct

Be respectful and considerate. By participating in this project, you agree to abide by the Code of Conduct (if present).

Need Help?

If you have any questions, please open an issue or join the discussion on GitHub. We're happy to help!