mirror of https://github.com/jeffusion/gitea-ai-assistant.git synced 2026-03-27 10:05:50 +00:00

Files

jeffusion c313764b61 docs(readme): reorganize docs and screenshot gallery

Align project docs with current behavior using progressive disclosure and bilingual deep-dive guides. Add per-page admin screenshots with consistent page-* naming to make UI documentation clearer.

2026-03-24 16:04:57 +08:00

1.2 KiB

Raw Blame History

Getting Started

Prerequisites

Bun >= 1.2.5
A reachable Gitea instance
At least one LLM provider credential

Install

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

bun install at repository root installs frontend dependencies via postinstall.

If lifecycle scripts are disabled:

bun run bootstrap

Minimal environment

Create .env:

PORT=5174
ENCRYPTION_KEY= # required, generate with: openssl rand -hex 32
# DATABASE_PATH=./data/assistant.db

ENCRYPTION_KEY is required. Application startup fails when it is missing.

Run

bun run dev
# or
bun run start

Open http://your-server:5174
Default admin password is password on first boot
Change admin password immediately after login

Webhook setup

Option A: Admin UI (recommended)

In repository list, click enable to auto-provision webhook.

Option B: Manual

In Gitea repository settings:

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

Health endpoint

Use /api/health to check service status.

1.2 KiB Raw Blame History