← Open Source
kodustech

kodus-ai

Open source, self-hosted AI code review. Bring your own LLM.

ApplicationsCodingTypeScript
Open on GitHub
Momentum
+5stars in 24 hours+0.3%
1.45k
Stars
167
Forks
+26
This week
26
Contributors
Created 2025-03-28 · Updated 2026-10-05 · #1549 today
Top developers
README

koduslogo

PRs Welcome Github Stars License

Open source AI code review you can self-host, with the LLM you choose.

Kodus reviews pull requests on GitHub, GitLab, Bitbucket, Azure DevOps, and Forgejo. Run it on your own servers or use Kodus Cloud.


Website · Community · Docs · CLI Docs · Try Kodus Cloud · Self-Host Guide

🌐 English · Português (BR) · Español · 日本語 · 简体中文 · Français

Why Teams Choose Kodus

  • Model Agnostic: Use Claude, GPT-5, Gemini, Llama, GLM, Kimi or any OpenAI-compatible endpoint.
  • Zero Markup on LLM Costs: You pay model providers directly. No hidden multipliers.
  • Learns from Your Context: Kody adapts to your architecture, standards, and workflow.
  • You Set the Rules: Define custom review rules in plain language.
  • Privacy & Security: Source code is not used to train models, data is encrypted in transit and at rest, and self-hosted runners are supported. Self-hosted instances send one anonymous heartbeat per day. It carries aggregated counters and no code, names, or identifiers. Opt out with KODUS_TELEMETRY_DISABLED=true. See Anonymous Telemetry.
  • Native Git Workflow: Works directly in PRs with GitHub, GitLab, Bitbucket, Azure DevOps, and Forgejo.
  • CLI + CI/CD Ready: Run reviews locally and in pipelines.
  • Operational Impact: Track technical debt and delivery metrics while keeping review quality high.

Product Highlights

🔑 Bring Your Own Key

Connect your own provider credentials and choose the models behind Kodus reviews: OpenAI, Anthropic, Google Gemini, Vertex AI, Novita, or any OpenAI-compatible endpoint. Keep billing and usage under your own provider account, without hidden LLM markups.

Kodus BYOK model provider configuration

📈 Token Usage

Track token consumption across AI code reviews, understand cost drivers, and keep model spend predictable as adoption grows.

Kodus token usage dashboard

⚙️ Kody Rules

Kody Rules let teams define review instructions in plain language and apply them across organizations, repositories, paths, or specific review scopes. Kody uses those rules as context when reviewing pull requests, helping enforce architecture decisions, security expectations, testing practices, and repository-specific conventions without relying on reviewers to repeat the same feedback manually.

Kody rules

📊 Cockpit

Cockpit helps teams measure Kodus review effectiveness, Kody Rule health, repository health, and delivery metrics across the engineering workflow.

Kodus Cockpit showing AI code review pipeline health

🧩 Kody Issues

Automatically track unimplemented suggestions from closed pull requests, manage them by status, severity, category, and repository, and let Kody resolve them when the fix appears in a future PR.

Kodus Issues dashboard

🔎 See Kody reviewing a real pull request

Kody does more than summarize diffs. It reviews code with context, flags risks by severity, and suggests concrete fixes directly in the pull request.

Kody detecting a critical IDOR security issue in a pull request review

In this example, Kody catches a critical IDOR risk where an organizationId query parameter could bypass tenant protection when passed as an array, then suggests an explicit runtime validation before the code is merged.

Get Started

Choose the workflow that matches how you want to use Kodus.

  Try Kodus Cloud
    

  Start reviewing pull requests without managing infrastructure.
    

    

  [Create a free account](https://app.kodus.io/signup)
  ·
  [View pricing](https://kodus.io/pricing)




  Self-host Kodus
    

  For teams that need reviews to run inside their own infrastructure. It
  connects to self-managed GitLab and Forgejo, and it can use a model you
  host yourself. Kodus runs with Docker on a VM you control, with at least
  2 CPU cores, 8 GB of RAM, and 60 GB of free disk.
    

    

  [Installation guide](https://docs.kodus.io/how_to_deploy/en/deploy_kodus/generic_vm?utm_source=github&utm_medium=readme)
  ·
  [Request a trial license](https://tally.so/r/GxED1z)








  Use the CLI
    

  Run AI code reviews from your terminal against a working tree, staged diff,
  branch, or commit.
    

    

  kodus review
    

  kodus review --staged
    

  kodus review --prompt-only
    

    

  [CLI overview](https://docs.kodus.io/how_to_use/en/cli/introduction?utm_source=github&utm_medium=readme)
  ·
  [Command reference](https://docs.kodus.io/how_to_use/en/cli/commands?utm_source=github&utm_medium=readme)
  ·
  [CI/CD](https://docs.kodus.io/how_to_use/en/cli/ci_cd?utm_source=github&utm_medium=readme)




  Contribute Locally
    

  Run the Kodus monorepo locally for development across the API, worker,
  webhooks service, web app, and local infrastructure.
    

    

  git clone https://github.com/kodustech/kodus-ai.git
    

  cd kodus-ai
    

  yarn setup
    

    

  [Local quickstart](https://docs.kodus.io/how_to_deploy/en/local_quickstart/orchestrator?utm_source=github&utm_medium=readme)

Monorepo Structure

Kodus is a monorepo with multiple applications and shared domain libraries.

kodus-ai/
├── apps/
│   ├── api/          # NestJS API
│   ├── web/          # Next.js dashboard
│   ├── worker/       # Review execution and queue consumers
│   └── webhooks/     # Git provider webhook ingestion
├── libs/             # Shared NestJS domain modules (incl. libs/llm — LLM/BYOK layer)
└── scripts/          # Dev, deploy, benchmark, and automation scripts
Path Purpose
apps/api Main NestJS API for authentication, organizations, teams, Kody Rules, integrations, permissions, and code review orchestration.
apps/web Next.js web application for the Kodus dashboard.
apps/worker Background service for code review execution, queue processing, suggestion checks, automation jobs, and monitoring tasks.
apps/webhooks Webhook ingestion service for GitHub, GitLab, Azure Repos, Bitbucket, and Forgejo events.
libs Shared NestJS domain modules used across Kodus applications.
libs/llm In-repo LLM/BYOK abstraction layer for model providers.

For full setup instructions, follow the Local Quickstart.

Open Source vs. Teams vs. Enterprise

| Feature | Kody Community
Community | Kody Teams
Teams | Kody Enterprise
Enterprise | | :--- | :---: | :---: | :---: | | Price | Free | $10/dev monthly or $8/dev annual (+ tokens/dev) | Custom | | Hosting | Self-hosted or hosted by Kodus | Hosted by Kodus | Self-hosted or hosted by Kodus | | Bring Your Own Key (BYOK) | ✅ | ✅ | ✅ | | PR usage | Unlimited PRs using your own API key | Unlimited PRs using your own API key | Unlimited PRs using Kodus AI Tokens API key | | Users | Unlimited | Unlimited | Unlimited | | Kody Rules | Up to 10 | Unlimited | Unlimited | | Active plugins | Up to 3 | Unlimited | Unlimited | | Kody Memory | ✅ | ✅ | ✅ | | Quality Radar issues | Unlimited | Unlimited | Unlimited | | Priority queue for Kody Agents | ❌ | ✅ | ✅ | | Engineering Metrics / Cockpit | ❌ | ✅ | ✅ | | SSO | ❌ | ❌ | ✅ | | RBAC + audit logs + analytics | ❌ | ❌ | ✅ | | Compliance | ❌ | ❌ | SOC 2 | | Support | Discord Community Support | Discord Community + Email Support | Private Discord + Email + up to 5h/month dedicated onboarding/support |

Compare all plan →

Resources

Resource Description
Website Learn more about Kodus, product capabilities, and pricing.
Documentation Setup guides, product docs, CLI usage, and self-hosting instructions.
Kodus Cloud Start using Kodus without managing infrastructure.
Self-Host Guide Deploy Kodus in your own environment.
CLI Docs Run AI code reviews locally, in CI/CD, or inside coding agents.
Discord Community Ask questions, get setup help, and talk with the Kodus team.
Pricing Compare Community, Teams, and Enterprise editions.
Schedule a Call Talk with the Kodus team about setup, self-hosting, or enterprise needs.

Contributing

Kody contributing

We welcome contributions of all sizes 🧡

Fix a typo, improve the docs, report a bug, suggest a feature, or open a pull request for something you think should exist.

Not sure where to start? Open an issue or join the community. We’re happy to help.