# 🧠 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!