🐠

Clownfischserver

Dein Server. Dein Bot. Deine Regeln.
Ein Open-Source, KI-gestΓΌtzter Linux-Server-Manager – ausschließlich ΓΌber Telegram.

πŸ›‘οΈ GPL-3.0 🐧 Linux v0.5.0
⭐ GitHub Repo πŸ“¦ Installation
β€žWie der Clownfisch in seiner Anemone lebt – geschΓΌtzt, autonom, und beißt ΓΌberraschend hart."

⚑ Features

Alles was du fΓΌr deinen Server brauchst – in einem Telegram-Chat.

πŸ€–

Telegram Bot

PrimΓ€res Interface – von ΓΌberall, auch vom Handy. Kein Dashboard, keine Cloud.

🧠

Dual-Model KI

Code-Modell (qwen2.5-coder) fΓΌr Befehle + Chat-Modell (gemma3) fΓΌr Konversation – alles lokal mit Ollama.

πŸ”§

/shell + /ja

KI generiert Shell-Befehle aus natΓΌrlicher Sprache – du bestΓ€tigst vor der AusfΓΌhrung.

πŸ› οΈ

/code + Aider

Autonome Code- und Script-Generierung direkt auf dem Server via Aider.

πŸ“Έ

Automatische Snapshots

Vor destruktiven Aktionen sichert der Bot dein System – tar.gz mit Keep/Unkeep.

πŸ”

Port-Knocking SSH

SSH standardmÀßig blockiert. Zugang nur über Klopf-Sequenz mit Telegram-Alert.

☁️

OpenRouter Fallback

Kostenlose Cloud-Modelle springen ein, wenn Ollama mal nicht verfΓΌgbar ist. Opt-in.

πŸ“¦

Self-Update via Telegram

ZIP an den Bot schicken – er aktualisiert sich selbst, inkl. systemd-Services.

🌍

Mehrsprachig

Der Bot antwortet immer in der Sprache, in der du schreibst.

πŸ”’

DSGVO by Design

Lokal ist Standard, Cloud ist Opt-in. Keine Daten an Dritte.

πŸ“¦ Installation

Ein Befehl – und dein Server hat einen KI-Co-Piloten.

$ wget https://github.com/mehlzoerwer-claude/clownfischserver/archive/refs/heads/main.zip
$ unzip main.zip && cd clownfischserver-main
$ bash install.sh

πŸ–₯️ Ubuntu/Debian β€’ min. 8GB RAM empfohlen β€’ Root-Zugang fΓΌr Installation β€’ komplette Anleitung β†’

⌨️ Bot-Befehle

NatΓΌrliche Sprache trifft auf prΓ€zise Kontrolle.

/shell <text>KI generiert Shell-Befehl aus natΓΌrlicher Sprache
/jaLetzten Befehl ausfΓΌhren
/code <aufgabe>Aider erstellt/bearbeitet Code und Scripts
/run <befehl>Direkte Shell – kein KI, kein BestΓ€tigen
/statusCPU, RAM, Disk, Top-Prozesse
/snapshotSnapshot erstellen, anzeigen, verwalten
/ssh open/closeSSH-Zugang temporΓ€r ΓΆffnen/sperren
FreitextEinfach chatten – Fragen, Übersetzen, ErklΓ€ren

πŸ—οΈ Architektur

Modular, lokal, erweiterbar.

                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                    β”‚    Telegram Bot      β”‚
                    β”‚     (bot.py)         β”‚
                    β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β”‚      β”‚
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€      β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         β–Ό                 β–Ό      β–Ό                 β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ ollama_client  β”‚ β”‚  shell.py  β”‚ β”‚  aider_wrapper   β”‚
β”‚  (Dual-Model)  β”‚ β”‚ (run_shell)β”‚ β”‚  (Code-Agent)    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
        β”‚    β”‚
   β”Œβ”€β”€β”€β”€β”˜    └────┐
   β–Ό              β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚Gemma3 β”‚   β”‚Qwen-Coder β”‚   β”‚OpenRouter β”‚
β”‚(Chat) β”‚   β”‚  (Code)   β”‚   β”‚(Fallback) β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ›‘οΈ Prinzipien

WofΓΌr der Clownfischserver steht.

01

Local AI First

Lokal ist Standard. Cloud ist Opt-in.

02

Open Source Always

GPL-3.0, keine Ausnahmen.

03

DSGVO by Design

Datenschutz ist Pflicht, kein Feature.

04

Security First

SSH zu, KI prΓΌft, Snapshots sichern.

05

Einfachheit

Ein Mensch, ein Bot, ein Server.

06

Distro-agnostisch

Linux ist Linux. Die KI kennt den Unterschied.

πŸ—ΊοΈ Roadmap

Von v0.5.0 bis zur Weltklasse-App.

πŸ”’

v0.5.0 – Security

2FA, Rate-Limiting, Audit-Log, Output-Sanitizer, verschlΓΌsselte Snapshots.

🌐

v0.6.0 – Multi-Server

Ein Bot steuert mehrere Server. Zentrale Snapshot-Verwaltung.

πŸ”Œ

v0.9.0 – Multi-Interface

Matrix, Web-UI, SSH-CLI – ein Bot, viele EingΓ€nge.

πŸ”„

v2.0.0 – Cross-Distro

Server-Migration zwischen Distributionen. Ein Snapshot, jedes Zielsystem.

Bereit fΓΌr deinen KI-Co-Piloten?

🐠 Auf GitHub ansehen