Docs

Documentation

Proval runs as a self-hosted service for review automation. Connect a Git provider, configure a model provider, link repositories, and receive reviews when webhooks fire.

Quick start

Quick Start

Run Proval with Docker Compose and open the dashboard.

Git Provider

GitLab

Connect GitLab to Proval with a personal access token and project webhook.
Forgejo

Connect Forgejo to Proval with a personal access token and repository webhook.
GitHub

Connect GitHub to Proval with a GitHub App and repository linking.

LLM

Set LLM

Add a model provider in Proval with Base URL, API key, and model ID.
llama.cpp example

Run a local llama.cpp server for Proval.
OpenRouter example

Create an OpenRouter API key for Proval.

Quick start

Quick Start

Git Provider

GitLab

Forgejo

GitHub

LLM

Set LLM

llama.cpp example

OpenRouter example