Metadata-Version: 2.4
Name: klanker
Version: 0.0.1
Summary: Universal, adaptive slimemold AI agent shell on the Lolaplex suite
Author: Lolaplex
License-Expression: MIT
Project-URL: Homepage, https://github.com/Lolaplex/klanker
Project-URL: Repository, https://github.com/Lolaplex/klanker
Project-URL: Bug Tracker, https://github.com/Lolaplex/klanker/issues
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: agents-harness>=0.0.1
Requires-Dist: agents-relay>=0.0.1
Requires-Dist: agents-memory>=0.0.1
Requires-Dist: agents-traces>=0.0.1
Requires-Dist: agents-docs>=0.0.1
Provides-Extra: browser
Requires-Dist: agents-browser>=0.0.1; extra == "browser"
Provides-Extra: keys
Requires-Dist: agents-keys>=0.0.1; extra == "keys"
Provides-Extra: all
Requires-Dist: klanker[browser,keys]; extra == "all"
Provides-Extra: suite
Requires-Dist: klanker[browser,keys]; extra == "suite"
Dynamic: license-file

# Klanker 🤖

**The Adaptive Agent Distribution on the Lolaplex Suite.**

Klanker ist eine schlanke, adaptive Agenten-Distribution auf Basis des **Slimemold-Paradigmas**. Aufsetzend auf dem deterministischen Motor von `agents-harness` formt sich Klanker nach Bedarf:
- Vom autarken Server-Worker (`klanker cron`),
- über den direkten Terminal-Begleiter (`klanker chat`),
- bis zum vollwertigen VPS-Assistenten via Telegram & HTTP (`klanker serve`).

## Quickstart

```bash
# Clone & install (installiert den kompletten Agents Core Stack: harness, gateway, memory, traces, docs)
pip install -e .

# Optional: Zusätzliche Slimemold-Fühler aktivieren
pip install -e ".[browser]"   # CDP Browser Automation
pip install -e ".[keys]"      # Ed25519 Agent Keys
pip install -e ".[suite]"     # Volle Lolaplex Suite

# 1. Umgebung & Fühler prüfen
klanker sense

# 2. Dynamischen System-Prompt einsehen
klanker prompt

# 3. Interaktiver Chat (REPL)
klanker

# 4. Direkter Turn im Terminal
klanker "Wer bist du?"

# 5. I/O-Gateway starten (HTTP & Telegram)
klanker serve

# 6. Geplante Koru-Harness-Flows ausführen
klanker cron
```


## Die Architektur

1. **Das Brain (`agents-harness`)** — Motor, LLM-Streaming, Cordis-Kernel, Koru-Schedules, lokales Gedächtnis (`agents-memory`), JSONL-Observability & Chat-Rekonstruktion (`agents-traces`) und lokales Markdown-RAG (`agents-docs`).
2. **Die I/O-Schicht (`agents-relay`)** — Universelle Ein- und Ausgabe via HTTP (`/v1/turn`) und Telegram Long-Poll.
3. **Die User-App (`klanker`)** — Verbindet Brain & Relay zu einer adaptiven Slimemold-Shell.
4. **Optionale Tools & Fühler** — Externe Fähigkeiten wie CDP-Browser (`agents-browser`), Ed25519-Keys (`agents-keys`), Jailed Terminal (`agents-terminal`) oder beliebige MCP-Tools, die Klanker bei Bedarf vorschlägt oder einbindet.


