Files

86 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🧠 Gitea Sync AI Docker-Service
Ein lokaler Service, um Gitea-Repos abonnieren, mit KI bearbeiten und wieder pushen zu können.
Ideal für Nutzung mit **OpenWebUI** im Unraid!
---
## 🚀 Verwendung
### 1️⃣ Docker Image bauen (lokal oder via Gitea)
```bash
docker build -t gitea-sync-ai .
```
Oder binde es als GitLab- oder GitHub-Action ein, um automatisiert Images zu publischen.
---
### 2️⃣ Docker Compose starten
Vorher `.env` anlegen:
**`.env`** (Beispiel):
```
GITEE_URL=https://git.carabella.ch/
ACCESS_TOKEN=hier_dein_gitea_pat
COMMIT_NAME=KI-Sparringpartner
```
Dann:
```bash
docker-compose up -d
```
---
### 3️⃣ Unraid-Nutzung (Docker-Container direkt)
1. In Unraid → **Apps** -> + Add Container
2. Name: `gitea-sync-ai`
3. Image: lade es entweder lokal hoch (`localhost/gitea-sync-ai`) oder nutz ein Registry-Image
4. Port: `8000 → 8000`
5. Volume: `/home/user/projects:/projects`
6. Environment-Variablen setzen (ohne .env):
```
GITEE_URL=https://git.carabella.ch/
ACCESS_TOKEN=DEIN_TOKEN
COMMIT_NAME=KI-Sparringpartner
```
✅ Fertig! Öffne http://[deine-ip]:8000 im Browser.
---
## 🔐 Sicherheitshinweis
- **`ACCESS_TOKEN`** muss Einzelhandhabung haben (keinsichere `.env` oder Secrets nutzen!)
- Docker-Container läuft in isolierter Umgebung ideal fürheimnisches Umfeld
---
## 🧩 Features (v1.0)
| Feature | Status |
|--------|--------|
| Repo-Liste von Gitea 🎯 | ✅ |
| Abonnieren & Klonen 💾 | ✅ |
| File-Watcher 🔍 | ✅ |
| Changelog-Generator 📋 | ✅ |
| Push mit AI-Tags ↩️ | ⏳ (kommt bald) |
---
## 📌 TODO / Roadmap
- 🤖 OpenWebUI Integration für `analyze`, `improve`, `summarize`
- 🧠 Git-Hook zur KI-Begleitung bei Commits
- ☁️ Remote-Trigger via Knopfdruck (API-Webhook)
---
## 📜 Lizenz & Credits
Selbstgebaut mit ❤️ für dich und deine Projekte!