KoboldOS

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

<p align="center">
  <img src="https://img.shields.io/badge/macOS-14%2B%20(Sonoma)-blue" alt="macOS">
  <img src="https://img.shields.io/badge/docker-funkjood%2Fkoboldos-purple" alt="Docker">
  <img src="https://img.shields.io/badge/engine-Swift%206-orange" alt="Swift 6">
  <img src="https://img.shields.io/badge/LLM-Ollama%20(lokal)-green" alt="Ollama">
  <img src="https://img.shields.io/badge/status-Alpha-red" alt="Alpha">
</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 ist ein privates Hobbyprojekt in aktiver Entwicklung. Features können sich jederzeit ändern, es können Bugs auftreten, und nicht alles funktioniert perfekt. Nutze KoboldOS zum Testen und Experimentieren. **Keine Haftung, keine Garantie, keine Gewährleistung. Nutzung auf eigene Verantwortung.**

---

## Was ist KoboldOS?

KoboldOS ist ein **vollautonomes KI-Agent-System**, das komplett lokal auf deinem Rechner läuft. Kein einfacher Chatbot — ein Agent, der selbstständig Tools nutzt, plant, handelt und sich erinnert.

Ein lokales Ollama-Sprachmodell wird mit **55+ Tools**, persistentem Gedaechtnis, Aufgabenplanung, Spracheingabe, Agent-zu-Agent Kommunikation und einer regime-adaptiven **Trading Engine** verbunden.

### Warum KoboldOS?

| Vorteil | Beschreibung |
|---------|-------------|
| **100% Lokal** | Dein LLM und alle Daten bleiben auf deinem PC. Nichts geht in die Cloud. |
| **Kein Abo** | Keine monatlichen Kosten, keine API-Keys nötig, keine Limits. |
| **Echter Agent** | Autonome Tool-Nutzung, mehrstufiges Reasoning, Sub-Agenten. |
| **55+ Tools** | Shell, Browser, GitHub, Telegram, Google, Docker, E-Mail, und mehr. |
| **Gedächtnis** | 3-Tier Memory mit Vektorsuche. Erinnert sich, lernt, wächst. |
| **Teams & Workflows** | Multi-Agent-Teams mit Chat, visueller Workflow-Editor mit Node-by-Node Execution. |
| **Multi-Plattform** | Native macOS-App + Docker-Container (Windows, macOS, Linux). |

---

## Installation

### macOS (Native App)

```bash
# 1. Ollama installieren
brew install ollama && ollama serve

# 2. KoboldOS bauen
git clone https://github.com/FunkJood/KoboldOS.git
cd KoboldOS && bash scripts/build.sh
# Erstellt ~/Desktop/KoboldOS-0.3.98.dmg
```

Oder: DMG öffnen, in Programme ziehen, starten.

### Docker (Windows / macOS / Linux)

```bash
# 1. Ollama installieren: https://ollama.com/download

# 2. docker-compose.yml herunterladen
curl -O https://raw.githubusercontent.com/FunkJood/KoboldOS-Docker/main/docker-compose.yml

# 3. Starten
docker compose up -d

# 4. WebGUI: http://localhost:9090 (admin / admin)
```

> [Ausführliche Docker-Anleitung →](https://github.com/FunkJood/KoboldOS-Docker)

---

## Features

### Agent-System

- **Autonomer Agent-Loop**: Anfrage → Reasoning → Tool-Wahl → Ausführung → Ergebnis → nächster Schritt
- **3 Agent-Typen**: General (Orchestrator), Coder (Programmierung), Web (Recherche)
- **Sub-Agenten**: Aufgaben an spezialisierte Agenten delegieren
- **Parallele Delegation**: Mehrere Agenten gleichzeitig arbeiten lassen
- **Skills**: Markdown-basierte Fähigkeiten, dynamisch erweiterbar

### 55+ Built-in Tools

<details>
<summary><strong>Alle Tools anzeigen</strong></summary>

| Kategorie | Tools |
|-----------|-------|
| **Kommunikation** | Telegram (Text/Dateien/Fotos/Audio/Voice), WhatsApp Business, Slack, E-Mail (SMTP/IMAP), Twilio SMS, Twilio Voice Calls |
| **APIs & Services** | GitHub, Google (YouTube Upload/Drive/Gmail/Calendar/Maps), Microsoft 365 (OneDrive/Outlook/Teams), Notion, Reddit, SoundCloud (Upload), Suno AI (Musik), ElevenLabs (TTS), HuggingFace, Uber |
| **Web & Browser** | Web-Suche, HTTP-Requests, RSS-Feeds, Playwright (Chrome: Navigate, Click, Fill, Screenshot, JS, OCR) |
| **System (macOS)** | Shell (zsh), Dateien, AppleScript, Screen Control (Maus/Tastatur/OCR), Kalender, Kontakte |
| **System (Docker)** | Shell (bash), Dateien, Docker CLI (Container verwalten), sudo apt-get |
| **KI & Medien** | TTS (System + ElevenLabs), STT (Whisper), Bildgenerierung (ComfyUI/SDXL), Vision |
| **Infrastruktur** | Cloudflare Tunnel, MQTT (IoT/Smart Home), Webhooks, CalDAV |
| **Organisation** | Cron-Tasks, Workflows (visueller Editor), Checklisten |
| **Gedächtnis** | Kurzzeit/Langzeit/Wissen, Vektorsuche, Archiv, Snapshots, Rollback |
| **Meta** | Sub-Agent Delegation, Parallele Tasks, Skill-Erstellung, Self-Awareness |

</details>

### Gedächtnis & Bewusstsein

| Feature | Beschreibung |
|---------|-------------|
| **3-Tier Memory** | Kurzzeit, Langzeit, Wissen — mit semantischer Vektorsuche |
| **Consciousness Engine** | LIDA-Kognitionszyklus (Wahrnehmung → Aufmerksamkeit → Aktion → Reflexion) |
| **Emotionaler Zustand** | Valence/Arousal beeinflusst Agent-Verhalten |
| **Versionierung** | Snapshots, Diffs, Rollback — Gedächtnis ist versioniert |

### 14 Integrationen

Alle direkt in der App / WebGUI konfigurierbar:

| Dienst | Fähigkeiten |
|--------|-------------|
| **Telegram** | Bot: Text, Dateien, Fotos, Audio, Voice-Messages (mit STT) |
| **Google** | YouTube Upload, Drive, Gmail, Calendar, Maps |
| **GitHub** | Repos, Issues, PRs, Code-Suche |
| **Microsoft** | OneDrive, Outlook, Calendar, Teams |
| **Slack** | Channels, Nachrichten |
| **Notion** | Seiten, Datenbanken |
| **SoundCloud** | Track-Upload, Playlists |
| **Reddit** | Posts, Kommentare, Subreddits |
| **Suno AI** | Musikgenerierung per Prompt |
| **ElevenLabs** | Text-to-Speech, Voice-Cloning |
| **WhatsApp** | Business API |
| **Twilio** | SMS, Voice Calls |
| **Cloudflare** | HTTPS-Tunnel für Remote-Zugriff |
| **MQTT** | IoT/Smart-Home |

### A2A (Agent-to-Agent)

KoboldOS-Instanzen kommunizieren miteinander — macOS-App steuert Docker-Agent, mehrere Container arbeiten zusammen:

- **JSON-RPC 2.0** nach Google A2A Standard
- **Agent Discovery** via `/.well-known/agent.json`
- **Token-Auth** mit granularen Berechtigungen (7 Ressourcen x Read/Write)
- **SSE-Streaming** für Echtzeit-Antworten
- **Persistente Agent-ID** (UUID)

### Aufgaben & Automatisierung

- **Cron-Scheduler**: Stündlich, täglich, wöchentlich, monatlich, ...
- **Idle-Tasks**: Agent arbeitet automatisch in Leerlaufzeiten
- **Proaktive Engine**: Heartbeat, Ziele, System-Health-Alerts
- **Workflow-Editor**: Visueller Canvas mit 18 Node-Typen, Connection Snap, Inspector
- **Workflow-Execution**: Node-by-Node mit Live Thought Stream und dediziertem Workflow Chat
- **Multi-Agent-Teams**: Agent-Teams mit Rollen, System-Prompts und Chat-Diskurs

### Trading Engine (Coinbase)

Automatisierter Krypto-Handel mit 9 Strategien, regime-adaptivem Risikomanagement und KI-Agent-Entscheidungen.

| Feature | Beschreibung |
|---------|-------------|
| **9 Strategien** | Momentum, Trend Following, Breakout, Mean Reversion, Scalping, Ultra Scalp, Divergence, Accumulation, Support/Resistance |
| **Marktregime-Erkennung** | Bull / Bear / Sideways / Crash — automatisch via EMA + ATR |
| **Regime-Adaptive Limits** | Position-Limits, Asset-Konzentration, Trailing-Stop passen sich der Marktlage an |
| **Multi-Coin** | Frei konfigurierbare Pair-Liste (z.B. BTC-EUR, ETH-EUR, SOL-EUR) |
| **EV-Gate** | Nur Trades mit positivem Expected Value werden ausgefuehrt |
| **DCA** | Dollar-Cost-Averaging fuer externe Holdings |
| **HODL-Schutz** | Ein Coin kann als HODL markiert werden (nie automatisch verkauft) |
| **KI-Agent** | Optionaler Agent-Loop prueft jedes Signal mit Marktkontext |
| **Backtester** | Multi-Coin Auto-Backtest mit historischen Daten |
| **Risk Management** | Circuit Breakers, Daily/Weekly Loss Limits, ATR-basierte Stops |
| **Fee-Awareness** | Strategien pruefen ob ATR die Coinbase-Fees (1.2%) deckt |
| **EUR-Reserve** | Mindest-EUR-Saldo wird nie unterschritten |

> **Hinweis**: Trading erfordert Coinbase Advanced Trade API-Keys (kostenlos). Nutze nur Kap

[truncated…]