huggingface/serge

Python

17 environment variables found in .env.example

Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.

GITHUB_APP_ID GitHub App Numeric App ID from the GitHub App settings page.
GITHUB_PRIVATE_KEY_PATH secret Either inline PEM (with literal \n) or path to the private-key file.
GITHUB_WEBHOOK_SECRET secret
LLM_API_BASE LLM (any OpenAI-compatible service; base URL may include /v1 or not) Examples: OpenAI: https://api.openai.com or https://api.openai.com/v1…
LLM_API_KEY secret
MENTION_TRIGGER Review behaviour Phrase that must appear in a PR/issue comment to trigger a review.
REVIEW_EVENT One of COMMENT | REQUEST_CHANGES | APPROVE
MAX_DIFF_CHARS Hard cap on diff size sent to the LLM (characters).
REVIEW_RULES_PATH Path in the target repo to load repo-specific review rules from (default branch).
DEFAULT_REVIEW_RULES Fallback rules used when the repo does not ship REVIEW_RULES_PATH.
PORT Server
LOG_LEVEL
GITHUB_OAUTH_CLIENT_ID Interactive web app (reviewbot-web) Required in web mode unless DEV_NO_AUTH=1.
GITHUB_OAUTH_CLIENT_SECRET secret
GITHUB_OAUTH_CALLBACK_URL
WEB_SESSION_SECRET secret
WEB_ALLOWED_USERS

Best match Fly.io Anything Dockerized — requires the Fly CLI.

macOS

brew install flyctl && fly launch --from https://github.com/huggingface/serge

Linux

curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/huggingface/serge

Windows (PowerShell)

iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/huggingface/serge

Or deploy to a different host