Gitea AI Assistant

AI-powered code review assistant for Gitea. It receives webhooks, runs staged AI review workflows, and posts summary + line-level feedback back to Gitea.

• English docs: ./docs/README.md
• 中文文档: ./docs/README.zh-CN.md

Why this project

• 🤖 Automated PR + commit review via webhook events (pull_request, status)
• 🧠 Two review engines: agent (staged tasks) and codex (Codex CLI pipeline)
• 🧵 Pluggable LLM providers: OpenAI Compatible, OpenAI Responses API, Anthropic, Gemini
• 📍 Actionable output: summary comments and line-level findings
• 🎛️ Web Admin UI for runtime configuration (providers, models, webhook, review policy)
• 🔔 Notifications: Feishu + WeCom (企业微信)
• 🔐 Security-first defaults: webhook signature verification + encrypted API key storage

Product screenshot

Dashboard screenshot is generated from local dev service.

More screenshots (one per admin menu): EN | 中文

Architecture (high-level)

Gitea Webhook -> Gitea AI Assistant (Hono + Bun) -> LLM Gateway (multi-provider)
                                 |
                                 +-> Admin Dashboard (React)

For component-level design, see Architecture docs.

Quick start (minimal)

1) Prerequisites

• Bun >= 1.2.5
• Reachable Gitea instance
• At least one LLM provider credential

2) Install

git clone https://github.com/user/gitea-ai-assistant.git
cd gitea-ai-assistant
bun install

If lifecycle scripts are disabled in your environment, run:

bun run bootstrap

3) Minimal .env

PORT=5174
ENCRYPTION_KEY=   # required, 64 hex chars (openssl rand -hex 32)
# DATABASE_PATH=./data/assistant.db
# LOG_LEVEL=info   # dev default; use LOG_LEVEL=error in production

ENCRYPTION_KEY is mandatory. The app refuses to start without it.

4) Run

bun run dev
# or
bun run start

5) Configure in Admin UI

Open http://your-server:5174, login with default password (first boot only), then change it immediately.

• Configure Gitea API + tokens
• Configure webhook secret
• Configure LLM providers/models
• Configure review engine and policy

6) Add webhook in Gitea

• URL: http://your-server:5174/webhook/gitea
• Content-Type: application/json
• Secret: same as dashboard webhook secret
• Events: Pull Request + Status

Progressive disclosure: detailed docs

• Documentation index
• Getting started details
• Configuration reference
• Review engines
• Deployment (Docker / Compose / Kubernetes)

License

MIT License