Schnellstart
Diese Anleitung führt Sie von einem frischen macOS- oder Linux-Rechner zu einer funktionierenden Anyy-Einrichtung, dem ersten Gespräch im Dashboard und dem Nachweis, dass dieses einen Neustart des Dashboard-Prozesses übersteht.
Für wen diese Anleitung gedacht ist
Verwenden Sie diese Anleitung, wenn Sie:
- Anyy selbst unter macOS oder Linux betreiben möchten;
- Dashboard im Alltag bevorzugen, aber auch die dahinterliegenden Terminalbefehle kennen möchten;
- einen Anbieter-API-Schlüssel, eine unterstützte Abonnementanmeldung oder einen lokalen Ollama- oder LM-Studio-Server haben; und
- zuerst einen zuverlässigen Chat einrichten möchten, bevor Sie Nachrichtenkanäle, Automatisierung, Skills oder externe Werkzeuge ergänzen.
Der schnellste Weg
| Ziel | Erste Aktion | Nächste Aktion |
|---|---|---|
| Die vollständige visuelle Oberfläche verwenden | Anyy installieren | anyy setup, dann anyy dashboard ausführen |
| Im Terminal chatten | Anyy installieren und konfigurieren | anyy ausführen |
| Einen Prompt aus einem Skript senden | Das residente Gateway starten | anyy chat "..." ausführen |
| Telegram oder eine andere Nachrichtenplattform verbinden | Zuerst einen lokalen Chat prüfen | anyy setup channel ausführen |
Konfigurieren Sie einen Anbieter und führen Sie ein einfaches Gespräch, bevor Sie Ausweichrouting, Nachrichtenkanäle, Cron oder MCP-Server aktivieren. So bleiben Probleme beim ersten Start überschaubar und leicht zu diagnostizieren.
1. Anyy installieren
macOS oder Linux
Führen Sie den offiziellen nativen Installer aus:
curl -fsSL https://anyy.ai/install.sh | sh
Prüfen Sie dann, ob Ihre Shell den installierten Befehl findet:
anyy --version
Der Installer lädt die native Version herunter, prüft sie gegen CHECKSUMS.sha256, aktiviert sie im Anyy-Home-Verzeichnis und erstellt einen Befehlseinstieg, sofern dies sicher möglich ist.
Der Release-Installer unterstützt macOS und Linux auf amd64/x86_64 und arm64/aarch64. Er startet weder Gateway noch legt er Ihre Profildaten an; die Einrichtung erledigt dies erst bei Bedarf.
Ist anyy nicht im PATH, prüfen Sie die Installation mit dem vom Installer ausgegebenen Pfad Binary: und fügen Sie anschließend genau das in dessen PATH-Anweisung genannte Verzeichnis hinzu. Bei einer normalen Installation ohne Root liegt der Befehlseinstieg nach Möglichkeit unter $HOME/.local/bin.
2. Einen Anbieter wählen
Starten Sie den interaktiven Einrichtungsassistenten:
anyy setup
Für den kürzesten Weg zum ersten Chat:
- Wählen Sie Schnelleinrichtung.
- Wählen Sie einen Anbieter und dessen Authentifizierungsmethode.
- Wählen Sie ein Modell aus dem erkannten Katalog oder geben Sie eines ein, wenn der Anbieter eine manuelle Auswahl verlangt.
- Antworten Sie auf Modellausweichrouting einrichten? vorerst mit Nein.
- Wählen Sie Überspringen, wenn nach der Verbindung einer Nachrichtenplattform gefragt wird.
- Prüfen Sie Anbieter, Modell, Endpunkt und Anzahl der Geheimnisse. Bestätigen Sie Diese Änderungen schreiben?.
Die Einrichtung unterstützt mehrere Verbindungsarten:
| Was Sie bereits haben | Auswahl in der Einrichtung |
|---|---|
| OpenAI-API-Schlüssel | OpenAI → OpenAI-API-Schlüssel |
| ChatGPT-Abonnement | OpenAI → ChatGPT-Abonnement (Codex) |
| Anthropic-API-Schlüssel | Anthropic → Anthropic API |
| Claude-Code-Abonnement | Anthropic → Claude-Code-Abonnement |
| Lokales Ollama oder LM Studio | Ollama oder LM Studio; zuerst den lokalen Modellserver starten |
| Anderer kompatibler Dienst | OpenAI-kompatibel oder Anthropic-kompatibel, dann dessen Endpunkt angeben |
Der Assistent listet auch andere derzeit nutzbare Anbieter. Sein Anbieterkatalog ist die maßgebliche Liste für die installierte Anyy-Version.
Nach erfolgreicher Einrichtung erscheint setup complete. Prüfen Sie das Ergebnis mit:
anyy config
Dieser Befehl zeigt aktives Profil, Home, Konfigurationsdatei, Datenbank, Anbieter, Modell, Endpunkt und ob sich jede Zugangsdatenreferenz auflösen lässt. Geheime Werte werden nicht ausgegeben.
Wie Einstellungen gespeichert werden
Anyy hält jedes Profil in sich geschlossen:
- Anbieter- und Modelleinstellungen werden in
<PROFILE_HOME>/config.yamlgeschrieben; - durch Anyy verwaltete Zugangsdaten liegen separat unter
<PROFILE_HOME>/secrets/mit Dateimodus0600; und - Sitzungen und Laufzeitzustand liegen in
<PROFILE_HOME>/state.db.
Bei der Standardinstallation ohne Root ist <PROFILE_HOME> normalerweise $HOME/.anyy. Bei Root-Installation ist es /root/.anyy. Verwenden Sie anyy config, statt zu raten, wenn ANYY_HOME oder benannte Profile beteiligt sind.
Der Assistent bereitet Änderungen vor und zeigt eine abschließende Prüfung. Ein Abbruch vor Diese Änderungen schreiben? lässt die vorbereitete Konfiguration ungeschrieben.
3. Den ersten Chat starten
Dashboard ist die empfohlene erste Oberfläche, weil es Chat, Sitzungen, Anbieter, Werkzeuge, Erinnerungen, Rollen, Profile, Kanäle, Skills, MCP und Cron in einer Oberfläche vereint.
Starten Sie es aus einem interaktiven Terminal:
anyy dashboard
Läuft das residente Gateway nicht, zeigt Anyy Gateway erforderlich und fragt:
Start Anyy Gateway now? [Y/n]:
Drücken Sie zum Zustimmen Enter. Anyy installiert und startet bei Bedarf den Hintergrunddienst, wartet auf dessen Bereitschaft und öffnet dann Dashboard weiter. Das Gateway bleibt nach dem Ende des Dashboard-Prozesses verfügbar.
Standardmäßig gibt Anyy eine URL für Diesen Rechner und alle nutzbaren URLs für das Lokale Netzwerk auf Port 8767 aus. Ein interaktiver Aufruf öffnet die URL für diesen Rechner automatisch. Mit --no-open lassen Sie nur die URLs ausgeben:
anyy dashboard --no-open
Um nur eine explizite Loopback-Adresse statt automatischer lokaler Netzwerk-Listener zu binden, führen Sie Folgendes aus:
anyy dashboard --listen 127.0.0.1:8767
Die ausgegebenen URLs enthalten temporäre Zugriffstoken. Fügen Sie sie nicht in Chats, Protokolle, Issues oder Screenshots ein. Mit Ctrl+C im Terminal stoppen Sie den Dashboard-Listener.
Die erste Nachricht senden
Im Dashboard:
- Öffnen Sie Chat.
- Wählen Sie Neue Sitzung.
- Senden Sie diesen Prompt:
Introduce yourself as Anyy in one sentence, then list three things you can help me do.
Die Einrichtung funktioniert, wenn die Antwort erscheint und die Sitzung im Sitzungsbereich aufgeführt ist.
Die Anfrage kann Anbieterkontingent verbrauchen oder Gebühren verursachen. Schreiben Sie keine API-Schlüssel, Zugriffstoken oder andere Geheimnisse in einen Prompt.
4. Sitzungen prüfen
Belassen Sie es nicht bei einer einzelnen Antwort. Prüfen Sie, dass das Gespräch dauerhaft gespeichert wird:
- Senden Sie in derselben Sitzung eine Folgenachricht.
- Drücken Sie
Ctrl+Cim Terminal, in dem Dashboard läuft. - Führen Sie
anyy dashboarderneut aus. - Öffnen Sie Chat und wählen Sie die frühere Sitzung.
- Prüfen Sie, dass beide Gesprächsschritte vorhanden sind, und senden Sie eine weitere Folgenachricht.
Dies prüft drei getrennte Wege: Sitzungsspeicherung, erneute Dashboard-Verbindung und weitere Ausführung über das residente Gateway.
Für das entsprechende Terminalverhalten führen Sie anyy aus, geben /sessions ein und wählen ein früheres Gespräch. Kennen Sie die Sitzungs-ID bereits, können Sie es direkt öffnen:
anyy --resume SESSION_ID
5. Wichtige Funktionen ausprobieren
Dashboard-Steuerung
Prüfen Sie über die Navigation die gerade erstellte Einrichtung:
- Übersicht zeigt Laufzeitzustand und ausgewähltes Profil.
- Modelle zeigt Anbieterverbindungen, Authentifizierungsstatus, verfügbare Modelle und das aktive Modell.
- Chat trennt normale Gespräche von Hintergrundsitzungen.
- Rollen und Erinnerungen steuern Identität und dauerhaften persönlichen Kontext.
- Unter Werkzeuge, Skills, MCP, Kanal und Cron ergänzen Sie Fähigkeiten, nachdem der grundlegende Chat stabil läuft.
Chat hat eine einzige Schaltfläche Senden. Während eines Laufs erscheinen neue Eingaben in der Warteschlange oberhalb der Nachrichteneingabe; ein wartender Eintrag kann die aktive Arbeit Steuern. Verwenden Sie Shift+Enter für einen Zeilenumbruch, Escape zum Unterbrechen und / für das Menü verfügbarer Befehle. Siehe Chat-Steuerung.
Terminaloberfläche
Öffnen Sie die TUI mit:
anyy
Nützliche Befehle sind:
/help Show commands and keyboard shortcuts
/new Start a new session
/sessions Open recent sessions
/status Show the current conversation state
/model Inspect or change the active model
/provider Inspect providers and provider authentication
/usage Show provider usage and context
/skills Insert an available Skill command
In der TUI sendet Enter im Leerlauf und steuert während der Arbeit; Alt+Enter stellt eine Folgenachricht in die Warteschlange. Shift+Enter oder Ctrl+J fügt einen Zeilenumbruch ein. Mit /quit beenden Sie die TUI; Unterbrechung und Rückgabe ausstehenden Texts sind unter TUI-Steuerung beschrieben.
Einmalige CLI-Aufrufe
Senden Sie bei laufendem residentem Gateway einen Prompt, ohne eine vollständige Oberfläche zu öffnen:
anyy chat "Give me a five-line summary of what Anyy can do."
Ergänzen Sie --json für maschinenlesbare Ausgabe. Aktivierte Werkzeuge werden direkt ausgeführt; prüfen Sie daher Aufgabe, Pfade und Zielkonto vor dem Absenden.
6. Die nächste Ebene ergänzen
Ergänzen Sie nur die als Nächstes benötigte Fähigkeit:
| Fähigkeit | Einstieg | Ergänzung |
|---|---|---|
| Nachrichtenkanäle | anyy setup channel | Eine unterstützte Nachrichtenplattform verbinden und ihre Zugriffsrichtlinie konfigurieren |
| Modellausweichroute | anyy setup model fallback | Eine geordnete Ersatzkette von Anbietern/Modellen hinzufügen |
| Web-, Bild-, Video- oder Sprach-Backends | anyy tools | Optionale Fähigkeitsdienste konfigurieren |
| Skills | anyy skills list | Installierte Skills prüfen, bevor Sie weitere ergänzen |
| MCP | anyy mcp --help | MCP-Server und Werkzeuge hinzufügen, authentifizieren, prüfen, aktivieren und aufrufen |
| Geplante Arbeit | anyy cron --help | Wiederkehrende Aufträge mit Zeitplan und Zustelleinstellungen erstellen und verwalten |
Dashboard ist ein bei Bedarf gestarteter Web-Begleitprozess. Gateway ist die residente Laufzeit. Das Stoppen von Dashboard mit Ctrl+C schließt den Web-Listener; ein als Hintergrunddienst installiertes Gateway läuft weiter.
Häufige Fehlerfälle
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
anyy: command not found | Das Befehlseinstiegsverzeichnis steht nicht im PATH | Folgen Sie genau der PATH-Anweisung des Installers, öffnen Sie die Shell neu und führen Sie anyy --version aus |
| Die Einrichtung endet nach einer leeren API-Schlüsselabfrage | Leere Eingabe bricht die erstmalige API-Schlüsseleinrichtung ab | Führen Sie anyy setup model erneut aus und geben Sie einen gültigen Schlüssel ein oder wählen Sie einen Abonnement-/lokalen Anbieter |
| Ollama- oder LM-Studio-Modelle sind nicht verfügbar | Der lokale Modellserver läuft nicht oder der Endpunkt ist falsch | Starten Sie den lokalen Server und führen Sie anyy setup model erneut aus |
| Dashboard meldet Gateway erforderlich | Kein residentes Gateway ist erreichbar | Stimmen Sie zu oder führen Sie anyy gateway start und dann anyy dashboard aus |
127.0.0.1:8767 wird bereits verwendet | Ein anderes Dashboard oder ein Prozess belegt den Port | Führen Sie anyy dashboard --status aus, stoppen Sie ein altes Dashboard mit anyy dashboard --stop oder verwenden Sie --listen 127.0.0.1:8768 |
| Dashboard öffnet sich, aber Chat kann nicht senden | Anbieter, Modell, Authentifizierung oder Gateway-Zustand ist ungültig | Führen Sie anyy config, anyy status und anyy doctor aus; wiederholen Sie bei Bedarf anyy setup model |
anyy chat kann keine Verbindung herstellen | Einmaliger Chat startet das residente Gateway nicht | Führen Sie zuerst anyy gateway start aus |
| Eine gespeicherte Sitzung scheint zu fehlen | Ein anderes Profil oder Home ist ausgewählt | Vergleichen Sie das im Dashboard angezeigte Profil und Home mit anyy config |
Werkzeuge zur Wiederherstellung
Verwenden Sie diese Reihenfolge, damit jeder Befehl das Problem eingrenzt, bevor Sie etwas ändern:
-
Prüfen Sie ausgewählte Laufzeit und Profil:
anyy statusanyy config -
Führen Sie die integrierte Diagnose aus:
anyy doctor -
Ist das Gateway fehlerhaft und kein Gesprächsschritt aktiv, starten Sie es neu:
anyy gateway restart -
Sind Anbieteranmeldung oder Modellauswahl falsch, reparieren Sie nur diese Ebene:
anyy setup model -
Ist der Dashboard-Listener das Problem, prüfen und stoppen Sie alte Dashboard-Prozesse und starten Sie anschließend einen neuen:
anyy dashboard --statusanyy dashboard --stopanyy dashboard -
Gibt es mehrere Profile, prüfen Sie, welches aktiv ist:
anyy profile list
Kurzreferenz
| Befehl | Zweck |
|---|---|
anyy | Die interaktive Terminaloberfläche öffnen |
anyy dashboard | Dashboard starten und die URL für diesen Rechner öffnen |
anyy dashboard --no-open | Dashboard ohne Öffnen eines Browsers starten |
anyy chat "PROMPT" | Einen Prompt über das residente Gateway senden |
anyy --resume SESSION_ID | Eine vorhandene Sitzung in der TUI öffnen |
anyy status | Laufzeit- und Gateway-Status anzeigen |
anyy doctor | Konfigurations- und Laufzeitdiagnose ausführen |
anyy config | Aufgelöste Pfade, Anbieter, Modell und Zugangsdatenstatus anzeigen |
anyy gateway start | Den residenten Gateway-Dienst installieren und starten |
anyy gateway restart | Den residenten Gateway-Dienst neu starten |
anyy setup model | Anbieter, Authentifizierung, Modell und optionales Ausweichrouting konfigurieren |
anyy setup channel | Nachrichtenplattformen konfigurieren |
anyy update --check | Auf eine neuere native Version prüfen |
Nächste Schritte
- Lernen Sie die visuelle Steuerungsoberfläche unter Dashboard kennen.
- Ergänzen oder ändern Sie einen Anbieter unter Modelle konfigurieren.
- Lernen Sie Terminalbefehle und Tastatursteuerung unter TUI kennen.
- Verbinden Sie eine Nachrichtenplattform unter Nachrichtenkanäle.
- Verschaffen Sie sich unter Funktionen einen Überblick über das restliche Produkt.
- Schlagen Sie genaue Flags in der CLI-Befehlsreferenz nach.