Contributing to Guardrails

Welcome and thank you for your interest in contributing to Guardrails! We appreciate all contributions, big or small, from bug fixes to new features. Before diving in, let's go through some guidelines to make the process smoother for everyone.

promptBeginner5 min to valuemarkdownQuality: 59

0 views

Feb 1, 2026

Contributing to Guardrails

Getting Started

If you're fixing a bug or typo, feel free to submit a Pull Request directly.
For new features or bug fix discussions, open an issue or join our Discord server to chat with the community.

Setting Up Your Environment

Clone the repository: git clone https://github.com/guardrails-ai/guardrails.git
Enter the project directory: cd guardrails
Install the project in developer mode (use a virtual environment if preferred): make dev
Install pre-commit: pre-commit install

Development Workflow

Follow these steps before committing your changes:

Ensure tests pass: make test
Format your code: make autoformat
Run static analysis: make type
Update documentation: make docs-gen

Optional: Pre-Commit Hooks

For convenience, consider installing the pre-commit hooks provided in the repository. These hooks automatically run tests and formatting checks each time you commit, reducing development overhead.

Submitting a Pull Request

Ensure all tests pass and code is formatted.
Create a pull request with a clear description of your changes. Link to relevant issues or discussions. Follow this guide if needed.
Address any failing checks before requesting a review.
Engage in the code review process and make any necessary changes.
Celebrate when your pull request is merged! Your changes will be available in the next Guardrails release.

Thank you for your contribution and happy coding!

Contributing to Guardrails

Getting Started

If you're fixing a bug or typo, feel free to submit a Pull Request directly.
For new features or bug fix discussions, open an issue or join our Discord server to chat with the community.

Setting Up Your Environment

Clone the repository: git clone https://github.com/guardrails-ai/guardrails.git
Enter the project directory: cd guardrails
Install the project in developer mode (use a virtual environment if preferred): make dev
Install pre-commit: pre-commit install

Development Workflow

Follow these steps before committing your changes:

Ensure tests pass: make test
Format your code: make autoformat
Run static analysis: make type
Update documentation: make docs-gen

Optional: Pre-Commit Hooks

For convenience, consider installing the pre-commit hooks provided in the repository. These hooks automatically run tests and formatting checks each time you commit, reducing development overhead.

Submitting a Pull Request

Ensure all tests pass and code is formatted.
Create a pull request with a clear description of your changes. Link to relevant issues or discussions. Follow this guide if needed.
Address any failing checks before requesting a review.
Engage in the code review process and make any necessary changes.
Celebrate when your pull request is merged! Your changes will be available in the next Guardrails release.

Thank you for your contribution and happy coding!

Contributing to Guardrails

Contributing to Guardrails

Getting Started

Setting Up Your Environment

Development Workflow

Optional: Pre-Commit Hooks

Submitting a Pull Request

Related Skills

<h1 align="center">

Frontend Typescript Linting.mdc

2. Apply Deepthink Protocol (reason about dependencies

Contributing to Guardrails

Getting Started

Setting Up Your Environment

Development Workflow

Optional: Pre-Commit Hooks

Submitting a Pull Request