Schnellstart

Installation

Laden Sie den neuesten Installer von der Download-Seite oder GitHub Releases herunter.

macOS

Chip	Datei
Apple Silicon (M1 / M2 / M3 / M4)	AQBot_x.x.x_aarch64.dmg
Intel	AQBot_x.x.x_x64.dmg

1. Öffnen Sie die .dmg und ziehen Sie AQBot in den Programme-Ordner.
2. Starten Sie AQBot. Wenn macOS die App blockiert, gehen Sie zu Systemeinstellungen → Datenschutz & Sicherheit und klicken Sie auf Trotzdem öffnen.

macOS: „App ist beschädigt" oder „Entwickler kann nicht überprüft werden"

Wenn Sie eine dieser Meldungen sehen, öffnen Sie Terminal und führen Sie aus:

xattr -c /Applications/AQBot.app

Starten Sie die App dann erneut. Dies entfernt das Quarantäne-Flag, das macOS auf unsignierte Downloads anwendet.

Windows

Architektur	Datei
x64 (die meisten PCs)	AQBot_x.x.x_x64-setup.exe
ARM64	AQBot_x.x.x_arm64-setup.exe

Führen Sie den Installer aus und folgen Sie dem Assistenten. Starten Sie AQBot über das Startmenü oder die Desktop-Verknüpfung.

Linux

Format	Architektur	Datei
Debian / Ubuntu	x64	AQBot_x.x.x_amd64.deb
Debian / Ubuntu	ARM64	AQBot_x.x.x_arm64.deb
Fedora / openSUSE	x64	AQBot_x.x.x_x86_64.rpm
Fedora / openSUSE	ARM64	AQBot_x.x.x_aarch64.rpm
Beliebige Distribution	x64	AQBot_x.x.x_amd64.AppImage
Beliebige Distribution	ARM64	AQBot_x.x.x_aarch64.AppImage

# Debian / Ubuntu
sudo dpkg -i AQBot_x.x.x_amd64.deb

# Fedora / openSUSE
sudo rpm -i AQBot_x.x.x_x86_64.rpm

# AppImage (beliebige Distribution)
chmod +x AQBot_x.x.x_amd64.AppImage
./AQBot_x.x.x_amd64.AppImage

---

Ersteinrichtung

1. Einstellungen öffnen

Starten Sie AQBot und klicken Sie auf das Zahnrad-Symbol unten in der Seitenleiste, oder drücken Sie Cmd/Ctrl+,.

2. Anbieter hinzufügen

Navigieren Sie zu Einstellungen → Anbieter und klicken Sie auf die Schaltfläche +.

1. Geben Sie einen Anzeigenamen ein (z.B. OpenAI).
2. Wählen Sie den Anbietertyp (OpenAI, Anthropic, Google Gemini usw.).
3. Fügen Sie Ihren API-Schlüssel ein.
4. Bestätigen Sie die Base URL — für integrierte Typen ist der offizielle Endpoint vorausgefüllt.

TIP

Sie können beliebig viele Anbieter hinzufügen. Jeder Anbieter verwaltet seine eigenen API-Schlüssel und Modelle unabhängig.

3. Modelle abrufen

Klicken Sie auf Modelle abrufen, um die Liste der verfügbaren Modelle von der API des Anbieters zu laden. Sie können Modell-IDs auch manuell hinzufügen.

4. Standardmodell festlegen

Gehen Sie zu Einstellungen → Standardmodell und wählen Sie den Anbieter und das Modell, das neue Gespräche standardmäßig verwenden sollen.

---

Ihr erstes Gespräch

1. Klicken Sie auf Neuer Chat in der Seitenleiste (oder drücken Sie Cmd/Ctrl+N).
2. Wählen Sie ein Modell aus dem Modell-Selektor oben im Chat.
3. Geben Sie eine Nachricht ein und drücken Sie Enter.
4. AQBot streamt die Antwort in Echtzeit. Modelle mit Denkblöcken (z.B. Claude, DeepSeek R1) zeigen den Reasoning-Prozess in einem einklappbaren Bereich.

---

Tastenkürzel

Kürzel	Aktion
Cmd/Ctrl+Shift+A	Aktuelles Fenster ein-/ausblenden
Cmd/Ctrl+Shift+Alt+A	Alle Fenster ein-/ausblenden
Cmd/Ctrl+Shift+W	Fenster schließen
Cmd/Ctrl+N	Neues Gespräch
Cmd/Ctrl+,	Einstellungen öffnen
Cmd/Ctrl+K	Befehlspalette
Cmd/Ctrl+Shift+G	API-Gateway umschalten

---

Daten und Backup

Datenverzeichnisse

Pfad	Inhalt
~/.aqbot/	Anwendungszustand — Datenbank, Verschlüsselungsschlüssel, Vektor-DB, SSL-Zertifikate
~/Documents/aqbot/	Benutzerdateien — Bilder, Dokumente, Backups

---

Nächste Schritte

• Anbieter konfigurieren — KI-Anbieter hinzufügen und verwalten
• MCP-Server — Externe Tools zur Erweiterung der KI-Fähigkeiten verbinden
• API-Gateway — Ihre Anbieter als lokalen API-Server exponieren