If you want to help Agenta run well in more environments, community projects are the place to contribute.
Community projects give deployment work a clear home. They help contributors understand:
- which setup or environment the work is about
- who is expected to maintain it
- what level of support users should expect
Where Contributors Can Help Today
The source of truth for the current matrix lives in docs/community-topics.md in the repository.
Use the official OSS quick start as the reference deployment surface. Community projects extend Agenta to additional environments beyond that baseline.
| Surface | Role | Support expectation | Start here |
|---|
| Local OSS with Docker Compose | Official baseline and reference point for new deployment work | support/official | Quick Start |
| Railway OSS | Current community-managed deployment surface for Agenta OSS | support/experimental | Deploy on Railway |
How To Contribute
- Pick a tracked deployment surface and read the matching guide before changing scripts or docs.
- Use the label families in the appendix to find the right GitHub issues and discussions for that setup.
- When you improve a tracked surface, update the docs, scripts, and ownership or support metadata together.
- If you want to propose a new deployment surface, open an issue or discussion first and describe the provider, platform, runtime, OLAP backend, maintenance owner, and support level.
Update these items in the same change:
docs/community-topics.md.github/.labels.ymlCODEOWNERS- the relevant setup docs and README files
Appendix: Label Taxonomy
Each tracked deployment surface is described with a small set of dimensions:
| Dimension | Label family | Meaning |
|---|
| Provider | provider/* | Who provides the infrastructure or hosting environment |
| Platform | platform/* | The deployment target or environment shape |
| Runtime | runtime/* | How Agenta is run or orchestrated |
| OLAP | olap/* | The storage or analytics backend classification used by the setup |
| Maintenance | maintenance/* | Who is expected to keep the setup working |
| Support | support/* | The level of promise made to users |
Use maintenance/* to understand who is expected to fix and update a setup. Use support/* to understand whether a deployment surface is official or best-effort.
Provider Labels
Runtime Labels
OLAP Labels
Maintenance Labels
Support Labels