mirror of
https://github.com/jeffusion/gitea-ai-assistant.git
synced 2026-06-06 07:26:49 +00:00
44d52cddc5
- Zod findingResponseSchema + LLM repair for malformed model output (max 2 attempts) - Budget guards: maxSubagents, maxEmptyResponses, maxConsecutiveToolFailures - maxSubagents: refuse spawn at limit, allow model to summarize - consecutiveToolFailures: per-tool-call update, reset on success, immediate terminate - Tool permission scope system (6 scopes, allow/deny static policy, no ask) - allowListSpecified flag distinguishes subagent vs main agent resolution - SHA256 finding fingerprint with JSON tuple input (avoids colon ambiguity) - Token counting + context clipping via tokenlens (newline-boundary clipping) - diffBudget floor of 1000 tokens (prevents negative budget for small models) - tryParseFinalSubmission: full JSON first (preserves summaryMarkdown), Zod fallback - normalizeFinding: Zod-only validation, no lax fallback - E2E README: fix webhook signing (--data-binary, openssl dgst, repository.name)
Gitea AI Assistant
AI-powered code review assistant for Gitea. It receives webhooks, runs 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(native Agent pipeline) andcodex(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_KEYis 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