Skip to content

Latest commit

 

History

History
92 lines (70 loc) · 3.13 KB

CONTRIBUTING.md

File metadata and controls

92 lines (70 loc) · 3.13 KB

Contributing to ShuttleAI

Thank you for considering contributing to the ShuttleAI project! Your contributions, whether bug reports, feature requests, documentation improvements, or code, are invaluable.

We need your help with adding previous endpoints to the new wrapper!

The ShuttleAI Python SDK uses poetry, ruff for linting, black for formatting, and mypy for type checking. Ensure your code passes all checks before submitting a pull request.

Benefits

Top contributors receive a special role in the ShuttleAI Discord Server.

Example of a contributor with a special role

Lazy Contributing

You can submit a pull request without passing checks, but it will be marked as WIP and not merged until all checks pass.

Table of Contents

Code of Conduct

This project adheres to the Contributor Covenant Code of Conduct. Report unacceptable behavior to the ShuttleAI team.

How to Contribute

Reporting Bugs

Open an issue on GitHub with detailed steps to reproduce, expected behavior, and actual behavior.

Suggesting Features

Open an issue on GitHub with a clear and detailed description of the feature and potential use cases.

Improving Documentation

If you find unclear or incomplete documentation, make changes and submit a pull request.

Contributing Code

Follow the development setup and submission guidelines below.

Development Setup

Fork and Clone

Fork the repository and clone it to your local machine:

git clone https://github.com/your-username/shuttleai.git
cd shuttleai

Set Up the Environment

Install poetry:

pip install poetry
poetry install

Running Checks

Run linting and type checking:

poetry run ruff .
poetry run black .
poetry run mypy .

Running Tests

Run tests with pytest:

poetry run pytest .

Ensure you set the API key in a .env file:

SHUTTLEAI_API_KEY=your-api-key

Submitting Changes

Commit Messages

Follow the Conventional Commits specification.

Pull Requests

When submitting a pull request:

  • Write a clear and descriptive title.
  • Include a detailed description of the changes, motivation, and potential side effects.
  • Link relevant issues or pull requests.
  • Ensure all checks pass.

Community

For questions, reach out on Discord or contact the maintainers.