mirror of
https://github.com/jeffusion/gitea-ai-assistant.git
synced 2026-06-05 23:16:49 +00:00
4d0ad6bf20
- README.md: trim to product overview + minimal quick start + single navigation table; remove duplicated Quick start section - docs/README.md / zh-CN.md: rewrite as grouped navigation index with descriptions (Getting started / Reference / Deployment) - docs/getting-started.md / zh-CN.md: add screenshot preview, improve structure with numbered configuration steps, add "Next steps" cross-links - docs/configuration.md / zh-CN.md: fix heading hierarchy (### instead of ## 1)), convert Admin UI settings to tables, move Agent Definitions and Tool Permissions to review-engines.md - docs/review-engines.md / zh-CN.md: add Agent Definitions and Tool Permissions sections (migrated from configuration.md), add model resolution order, convert to tables for clarity - CONTRIBUTING.md: add development setup, code quality commands, PR workflow, and Conventional Commits convention
Gitea AI Assistant
AI-powered code review assistant for Gitea. Receives webhooks, runs AI review workflows, and posts summary + line-level feedback back to Gitea.
Features
- Automated PR & commit review via webhook events
- Dynamic Agent engine — main agent autonomously spawns subagents for focused analysis
- Codex engine — Codex CLI-backed review as an alternative pipeline
- Pluggable LLM providers — OpenAI Compatible, OpenAI Responses API, Anthropic, Gemini
- Web Admin UI — runtime configuration for providers, models, webhook, review policy
- Notifications — Feishu + WeCom (企业微信)
- Security-first — webhook signature verification + AES-256-GCM encrypted API key storage
Quick start
git clone https://github.com/jeffusion/gitea-ai-assistant.git
cd gitea-ai-assistant
bun install # installs frontend via postinstall
Create .env:
ENCRYPTION_KEY=$(openssl rand -hex 32)
bun run dev
Open http://localhost:5174, login with default password password (change it immediately), then configure Gitea, LLM providers, and webhook in the Admin UI.
See Getting Started for full setup walkthrough including webhook configuration.
Documentation
| Topic | Description |
|---|---|
| Getting Started | Full installation and setup walkthrough |
| Configuration | Environment variables and Admin UI settings |
| Review Engines | Agent engine, Codex engine, review modes |
| Deployment | Docker, Compose, and Kubernetes |
| Screenshots | Admin UI gallery |
Contributing
See CONTRIBUTING.md for development conventions and UI guidelines.
License
MIT