# Contributing

Thank you for your interest in Giselle! This document explains how you can engage with the project.

Please note we have a [code of conduct](CODE_OF_CONDUCT.md); please follow it in all your interactions with the project.

## Our contribution policy

Giselle is developed by the core team, and **we do not accept unsolicited external Pull Requests.** Pull requests opened without a prior invitation from the team will be closed without review.

This is not a judgment on the value of your work. Writing code has become inexpensive, but reviewing it carefully still depends on limited maintainer attention, and every external change widens the project's supply-chain surface. To keep Giselle secure and maintainable, code changes are merged by the core team.

This does **not** mean we don't want to hear from you — quite the opposite. There are many valuable ways to get involved, listed below.

## How you can contribute

- **Report a bug** — [open a bug report](https://github.com/giselles-ai/giselle/issues/new?template=1_bug_report.yml) with clear steps to reproduce.
- **Share an idea or ask a question** — start a thread on [GitHub Discussions](https://github.com/giselles-ai/giselle/discussions).
- **Report a security issue** — please follow our [Security Policy](SECURITY.md) rather than opening a public issue.
- **Spread the word** — star the repo and tell others who might find Giselle useful.

When filing a bug report, please try to make it:

- _Reproducible._ Include steps to reproduce the problem.
- _Specific._ Include as much detail as possible: which version, what environment, etc.
- _Unique._ Search the [issue archive](https://github.com/giselles-ai/giselle/issues) first -- your issue may already be addressed.
- _Scoped to a single bug._ One bug per report.

## Development environment setup

You're welcome to run Giselle locally for self-hosting or to explore the codebase.

Giselle has both a Cloud version and a Self-hosting version, which can be found in the following directories:

- Cloud: [apps/studio.giselles.ai/](apps/studio.giselles.ai/)
