Chatti/Einleitung

← Zurück zur Hauptseite

Willkommen zum Wiki des **Chatti Clients**. Diese Seiten erklären die wesentlichen Funktionen, Konzepte und Arbeitsabläufe.

Hinweis: Das Dokument ist noch in der Entstehungsphase (Mid December 2025), daher unvollständig!

Download oder: Wo krieg' ich's her!

Chatti läuft unter der GNU(MIT)-Lizenz, ist demnach, einschließlich der Quellen, kostenfrei erhältlich. Entwickler/Innen können das Chatti-Projekt über Git clonen.

Für Anwender/Innen hab' ich ein kleines ZIP-Archiv vorbereitet, das auf Chattis Homepage abrufbar ist. Hier der direkte Download-Link.

Voraussetzung ist ein installiertes Python 3.12 oder höher auf dem Zielsystem. Sofern das gegeben ist, reicht ein Einzeiler, der ein Installations-Script startet. Das befördert Chatti mit allen Abhängigkeiten in's $HOME des aktuellen Users. Adminrechte sind nicht nötig.

⚙️ Ersteinrichtung und Setup

Willkommen an Bord! 🚀 Chatti ist komplett in Python geschrieben. Du erhältst die Software hier oder über GitHub. Eine kurze Anleitung für die Installation steht weiter unten, ein detailliertes Tutorial für die unterschiedlichen Varianten findest du hier.

Bevor Chatti losplaudern kann, braucht er ein bisschen Zuwendung – und ein paar Werkzeuge.

🧰 Was du brauchst

- Python 3.12+ – je aktueller, desto besser

 (unter Linux via `apt install python3.12-venv`, unter macOS mit Homebrew: `brew install python`)

- Virtuelle Umgebung (empfohlen) damit dein System sauber bleibt:

 ```bash
 python3 -m venv .venv
 source .venv/bin/activate
 pip install -r requirements.txt
 ```

- Einen OpenAI API-Key – ohne den bleibt Chatti stumm.

 Wenn du noch keinen hast: Lies [docs/API-Keys.md](API-Keys.md).

Wenn du detaillierte Infos zur Installation benötigst: Lies [docs/installation-guide.md](installation-guide.md).

🧑‍💻 Erststart

Starte Chatti mit:

./chatti

Beim ersten Start fragt dich das Programm:

- nach deinem **API-Key**
- nach einem **Master-Passwort** (für lokale Verschlüsselung)
- nach deinem Benutzer- oder Aliasnamen

Zugunsten der Sicherheit muss dein Passwort ein paar Kriterien erfüllen.

- Mindestlänge: 12 Zeichen
- Es muss Buchstaben, Ziffern, Sonderzeichen enthalten.
- Bitte: **KEINE** Leerzeichen im Passwort! 🫣
- Bitte keine Keyboard-Walks ("qwert", "asdf"...)
- Bitte keine schwachen Passwörter ("1234", "fred"...)

Alles wird verschlüsselt gespeichert – nichts verlässt den Rechner in's Internet.

🧪 Testlauf („Smoke-Test“)

Führe zur Sicherheit einmal aus:

chatti --doctor

Der "Doctor" prüft, ob alles funktioniert: - API-Zugriff (Key gültig?) - Internetverbindung - Schreibrechte für Config- und Log-Verzeichnisse - Erreichbare Modelle (z. B. gpt-4o, gpt-5)

Wenn alles grün ist: Glückwunsch, dein Chatti lebt! 🎉

🧩 Modelle & Grenzen

Die Modelle unterscheiden sich in Preis, Geschwindigkeit und „Wissensstand“:

| Modell | Geschwindigkeit | Wissensstand | Bemerkung | |:--|:--:|:--:|:--| | gpt-3.5-turbo | ⚡⚡⚡ | 2021 | schnell & günstig | | gpt-4-turbo | ⚡⚡ | 2023 | solide Allround-Wahl | | gpt-4o | ⚡⚡⚡ | Ende 2024 | multimodal & robust | | gpt-5 | ⚡ | 2025 | neue Architektur, stabil & produktionsreif | | gpt-5-realtime | ⚡⚡ | 2025 | interaktive Preview-Variante (Beta) |

💡 *Tipp:* Du kannst das aktive Modell jederzeit wechseln mit: > `chatti --model gpt-5` Falls etwas nicht klappt: Der Befehl...

chatti --whoami

...zeigt dir, welcher Benutzer aktiv ist, welche Konfigurationspfade gelten – und ob Chatti deinen API-Key korrekt geladen hat.