Contributing

llmBreakr is MIT licensed and built in the open. Issues, discussions, and pull requests all happen on GitHub.

Where help is most valuable

• Provider adapters — OpenAI, Anthropic, and Gemini are supported today; more providers are planned, and the adapter pattern is designed for community contributions.
• Documentation — if something here is unclear, out of date, or missing an example, a PR against the docs is genuinely useful.
• Bug reports — reproducible issues with logs and request shapes are the fastest way to get something fixed.

Local setup for contributing

git clone https://github.com/yashb007/llmBreakr-ai-gateway.git
cd llmBreakr-ai-gateway

cd server && npm install && cp .env.example .env
cd ../web && npm install && cp .env.local.example .env.local

Run the server and dashboard separately in dev mode — see Installation for both.

Tech stack, at a glance

• Server: Node.js 18+, Express, MySQL (Sequelize), Redis
• Dashboard: Next.js 15, React 19, Tailwind CSS

Open an issue before starting on a large change (a new provider adapter, a schema change) so the approach can be agreed on before code is written.