mirror of https://github.com/jeffusion/gitea-ai-assistant.git synced 2026-06-06 07:26:49 +00:00

Files

jeffusion 1e38a0e5e0 refactor: replace fixed review workflow with dynamic agent framework

- Add agent-kernel runtime (MainAgentRunner with while-true state machine,
  subagent spawning, tool loop, budget control)
- Add review-agent entrypoint with read_file/search_code/spawn_subagent tools
- Add deterministic publish adapter with cross-specialist finding dedup
- Delete old fixed workflow (orchestrator, triage, specialist, judge agents,
  4 domain agents, critic/debate/reflexion agents, learning/memory system)
- Remove legacy ModelRole (planner/specialist/judge) from LLM types, gateway,
  config schema, DB, and frontend RoleAssignment UI
- Replace RoleAssignment with AgentModelSettings for role-based model config
- Add agent config API endpoints (GET/PUT /admin/api/agents/config)
- Add review session detail page with observability/findings/logs tabs
- Add runtime contract tests and review adapter integration tests
- Add E2E mock LLM with scripted behavior support for deterministic testing
- Update E2E test script with subagent and finding assertions
- Add e2e/README.md with real PR review testing guide
- Fix seed.sh to run gitea admin commands as git user (not root)
- Update docs (configuration, review-engines, deployment, README)
- Remove unused feedback controller, qdrant k8s manifest, embedding migration
- Add .omo/ and .opencode/ to .gitignore

2026-05-27 07:34:59 +08:00

3.0 KiB

Raw Blame History

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) 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

License

MIT License

3.0 KiB Raw Blame History