KoboldOS-Docker

<p align="center">
  <img src="assets/banner.svg" alt="KoboldOS Banner" width="700">
</p>

<p align="center">
  <img src="https://img.shields.io/docker/v/funkjood/koboldos?sort=semver&label=Version&color=orange" alt="Version">
  <img src="https://img.shields.io/docker/image-size/funkjood/koboldos/latest?label=Image&color=blue" alt="Image Size">
  <img src="https://img.shields.io/docker/pulls/funkjood/koboldos?label=Pulls&color=green" alt="Docker Pulls">
  <img src="https://img.shields.io/badge/Plattformen-amd64%20%7C%20arm64-purple" alt="Platforms">
</p>

<p align="center">
  <strong>Dein eigener KI-Agent. Lokal. Privat. Autonom.</strong><br>
  Keine Cloud. Keine Abos. Keine Datensammlung. Alles auf deinem Rechner.
</p>

---

> **Alpha-Software** — KoboldOS befindet sich in aktiver Entwicklung. Funktionen können sich jederzeit ändern, es können Bugs auftreten, und nicht alles funktioniert perfekt. Nutze es zum Testen und Experimentieren, aber verlasse dich nicht auf KoboldOS für kritische Aufgaben. **Keine Haftung, keine Garantie. Nutzung auf eigene Verantwortung.**

---

## Warum KoboldOS?

| Vorteil | Beschreibung |
|---------|-------------|
| **100% Lokal** | Dein LLM läuft auf deinem PC via Ollama. Keine Daten verlassen dein Netzwerk. |
| **Kein Abo** | Keine monatlichen Kosten, keine API-Keys nötig, keine Nutzungslimits. |
| **Echter Agent** | Nicht nur Chat — ein Agent der selbstständig Tools nutzt, plant und handelt. |
| **55+ Tools** | Shell, Browser, GitHub, Telegram, Google, Slack, E-Mail, Docker, und vieles mehr. |
| **Gedächtnis** | Erinnert sich an vorherige Gespräche, lernt deine Vorlieben, wächst mit dir. |
| **Zero-Config** | Ein Befehl, läuft. Kein Setup, keine Konfigurationsdateien. |
| **Multi-Plattform** | Windows, macOS, Linux — überall der gleiche Agent. |

---

## Installation

### Voraussetzung: Ollama

KoboldOS braucht [Ollama](https://ollama.com/download) als LLM-Backend. Installiere und starte es — KoboldOS erkennt Ollama automatisch und lädt ein passendes Modell.

### Docker starten

```bash
# 1. docker-compose.yml herunterladen (oder dieses Repo klonen)
curl -O https://raw.githubusercontent.com/FunkJood/KoboldOS-Docker/main/docker-compose.yml

# 2. Starten
docker compose up -d

# 3. WebGUI öffnen
# → http://localhost:9090
# → Login: admin / admin
```

Das war's. KoboldOS läuft.

<details>
<summary><strong>Ollama auch im Container? (ohne lokale Installation)</strong></summary>

```bash
docker compose --profile ollama up -d
```
Startet Ollama als zweiten Container. KoboldOS verbindet sich automatisch.
</details>

<details>
<summary><strong>Windows: Docker-Steuerung geht nicht?</strong></summary>

Falls KoboldOS auf Windows keine Docker-Container sehen kann:
1. **Docker Desktop** → Settings → General → "Expose daemon on tcp://localhost:2375" aktivieren
2. Oder Socket-Mount in `docker-compose.yml` ändern zu: `//./pipe/docker_engine:/var/run/docker.sock`

KoboldOS versucht automatisch einen TCP-Fallback.
</details>

---

## WebGUI

Die WebGUI läuft auf `http://localhost:9090` und bietet alles was du brauchst:

### Chat
- Token-für-Token SSE-Streaming
- Thinking-Panel (Agent-Reasoning sichtbar)
- Tool-Call Anzeige mit Erfolg/Fehler
- Session-Verwaltung: Suche, Umbenennen, Löschen
- Kontext-Balken mit Token-Nutzung

### Aufgaben
- 8 Cron-Presets (stündlich, täglich, wöchentlich, ...)
- Sofort-Ausführung ("Jetzt ausführen")
- Idle-Tasks: Agent arbeitet wenn er nichts zu tun hat

### Gedächtnis
- Tag-Cloud mit Typ-Filter
- Inline-Edit (direkt bearbeiten)
- Semantische Suche
- Embedding-Modell Auto-Download

### Einstellungen (12 Bereiche)
Persönlichkeit, Berechtigungen, Benachrichtigungen, Sprache & Audio, Datenschutz, Sicherheit (API-Token + Tresor), Agenten, Fähigkeiten, Gedächtnis, Integrationen, A2A, Über KoboldOS

### Integrationen
Alle Dienste direkt in der WebGUI einrichtbar:

GitHub, Telegram, Google, SoundCloud, Slack, Notion, Reddit, Suno AI, ElevenLabs, WhatsApp, Microsoft 365, E-Mail (SMTP), Twilio, Cloudflare

---

## Features im Detail

### 55+ Tools

| Kategorie | Tools |
|-----------|-------|
| **Kommunikation** | Telegram, WhatsApp, Slack, E-Mail, Twilio SMS/Voice |
| **APIs** | GitHub, Google (YT/Drive/Gmail), Microsoft 365, Notion, Reddit, SoundCloud, Suno, ElevenLabs, HuggingFace |
| **Web** | Browser/Suche, HTTP, RSS, Playwright (Chrome-Automation) |
| **System** | Shell (bash), Dateien, Docker-Container verwalten |
| **KI** | TTS, Vision, Musikgenerierung |
| **Infra** | Cloudflare Tunnel, MQTT (IoT), Webhooks, CalDAV |
| **Orga** | Cron-Tasks, Workflows, Checklisten |
| **Memory** | Kurzzeit/Langzeit/Wissen, Vektorsuche, Archiv |

### A2A (Agent-to-Agent)

Verbinde mehrere KoboldOS-Instanzen:
- **Server**: Token-Auth, granulare Berechtigungen (7 Ressourcen x Read/Write)
- **Client**: Remote-URL + Token eingeben → Verbinden
- **Agent-ID**: Persistente UUID, kopierbar
- **Protokoll**: JSON-RPC 2.0, SSE-Streaming, Agent Discovery

### Docker-Bewusstsein

Der Agent weiß, dass er in Docker läuft:
- `docker ps` — Laufende Container sehen
- `docker run` — Neue Container starten (z.B. Qdrant, Postgres)
- `docker exec` — Befehle in anderen Containern
- `sudo apt-get install` — Pakete installieren
- Automatische Socket-Erkennung (macOS, Linux, Windows)

### Gedächtnis

- **3 Typen**: Kurzzeit, Langzeit, Wissen
- **Consciousness Engine**: LIDA-Kognitionszyklus mit Emotionalem Zustand
- **Vektorsuche**: Semantische Ähnlichkeit via Embeddings
- **Versionierung**: Snapshots, Diffs, Rollback

---

## Konfiguration

### Umgebungsvariablen

| Variable | Default | Beschreibung |
|----------|---------|-------------|
| `KOBOLD_MODEL` | `qwen2.5:7b` | Ollama-Modell |
| `OLLAMA_HOST` | `http://host.docker.internal:11434` | Ollama-URL |
| `KOBOLD_WEB_USER` | `admin` | WebGUI Login |
| `KOBOLD_WEB_PASS` | `admin` | WebGUI Passwort |
| `KOBOLD_NAME` | `KoboldOS` | Agent-Name |
| `KOBOLD_PORT` | `9090` | Port |

### Persistenz

Docker Volume `kobold-data` speichert alles:
- Konfiguration, API-Token, Agent-ID
- Gedächtnis und Sessions

Überlebt Container-Neustarts und Updates.

---

## Update

```bash
docker compose pull && docker compose up -d
```

Oder in der WebGUI: Einstellungen → Über → "Nach Updates suchen"

---

## Plattformen

| Plattform | Architektur | Status |
|-----------|------------|--------|
| Windows (Docker Desktop) | amd64 | Funktioniert |
| macOS (Docker Desktop) | arm64 / amd64 | Funktioniert |
| Linux (Docker Engine) | amd64 / arm64 | Funktioniert |

> Es gibt auch eine [native macOS-App](https://github.com/FunkJood/KoboldOS) mit SwiftUI-Interface, Screen Control, Bildgenerierung und Spracheingabe.

---

## Technologie

- **Runtime**: Swift 6 auf Ubuntu 22.04
- **LLM**: Ollama (lokal)
- **WebGUI**: Embedded HTML/CSS/JS (kein Node.js)
- **Protokolle**: REST, SSE, JSON-RPC 2.0, A2A
- **Container**: Multi-Stage Build, ~900MB

---

## Haftungsausschluss

KoboldOS ist ein **privates Hobbyprojekt** in der **Alpha-Phase**. Es wird "as-is" bereitgestellt, ohne jegliche Garantie. Die Entwickler übernehmen **keine Haftung** für Schäden, Datenverlust oder sonstige Probleme, die durch die Nutzung von KoboldOS entstehen können. Nutze KoboldOS ausschließlich zu **Test- und Experimentierzwecken**.

Durch die Nutzung akzeptierst du, dass:
- KoboldOS Bugs enthalten kann und jederzeit unerwartetes Verhalten zeigen kann
- Der Agent Shell-Befehle ausführen kann, die dein System verändern
- Du selbst für die Sicherheit deiner API-Keys und Tokens verantwortlich bist
- Kein Support oder SLA garantiert wird

---

<p align="center">
  <strong>KoboldOS</strong> — Local-first, Privacy-focused AI Agent Runtime<br>
  Made by <a href="https://soundcloud.com/funkjood">FunkJood</a>
</p>