Skip to content

Contributing to ClientAI

Thank you for your interest in contributing to ClientAI! This guide is meant to make it easy for you to get started.

Setting Up Your Development Environment

Cloning the Repository

Start by forking and cloning the ClientAI repository:

git clone https://github.com/YOUR-GITHUB-USERNAME/clientai.git

Using Poetry for Dependency Management

ClientAI uses Poetry for managing dependencies. If you don't have Poetry installed, follow the instructions on the official Poetry website.

Once Poetry is installed, navigate to the cloned repository and install the dependencies:

cd clientai
poetry install

Activating the Virtual Environment

Poetry creates a virtual environment for your project. Activate it using:

poetry shell

Making Contributions

Coding Standards

  • Follow PEP 8 guidelines.
  • Write meaningful tests for new features or bug fixes.

Testing with Pytest

ClientAI uses pytest for testing. Run tests using:

poetry run pytest

Linting

Use mypy for type checking:

mypy clientai

Use ruff for style:

ruff check --fix
ruff format

Ensure your code passes linting before submitting.

Submitting Your Contributions

Creating a Pull Request

After making your changes:

  • Push your changes to your fork.
  • Open a pull request with a clear description of your changes.
  • Update the README.md if necessary.

Code Reviews

  • Address any feedback from code reviews.
  • Once approved, your contributions will be merged into the main branch.

Code of Conduct

Please adhere to our Code of Conduct to maintain a welcoming and inclusive environment.

Thank you for contributing to ClientAI🚀