Installation

Diese Seite beschreibt die Installation des nativen Befehls anyy auf macOS oder Linux. Danach sollte anyy --version funktionieren. Anbietereinrichtung, Profildaten und das residente Gateway sind separate Schritte.

Unterstützte Installer-Ziele

Der Installer für native Versionen unterstützt macOS und Linux auf amd64/x86_64 und arm64/aarch64. Natives Windows ist kein Installer-Ziel.

Schnellinstallation

Voraussetzungen

Sie benötigen:

• einen unterstützten macOS- oder Linux-Rechner;
• eine Internetverbindung zu anyy.ai; und
• POSIX-sh mit verfügbaren Befehlen curl, tar, gzip, awk, sed, mktemp, readlink und entweder sha256sum oder shasum.

Der Installer prüft die erforderlichen Befehle vor dem Herunterladen der Version. Für eine normale persönliche Installation sind keine Root-Rechte nötig.

Die neueste Version installieren

Führen Sie den offiziellen Installer aus:

curl -fsSL https://anyy.ai/install.sh | sh

Der Befehl wählt die Version für Ihr Betriebssystem und Ihre CPU-Architektur. Ein erfolgreicher Lauf endet mit Zeilen ähnlich diesen:

Installed Anyy <version>.
Command: anyy
Gateway: <current status>

Die Gateway-Zeile meldet den derzeit beobachtbaren Status. Sie bedeutet nicht, dass der Installer das Gateway gestartet oder konfiguriert hat.

Den Installer zuerst prüfen

Wenn Sie ein Remote-Skript nicht direkt an sh weiterleiten möchten, öffnen Sie anyy.ai/install.sh oder laden und prüfen Sie es vor der Ausführung. Das veröffentlichte Skript ist derselbe Einstiegspunkt, den der obige Befehl verwendet.

Die Installation prüfen

Führen Sie Folgendes aus:

anyy --version

Die Ausgabe sollte so beginnen:

Anyy (anyy) version

Gibt der Installer Binary: statt Command: anyy aus, führen Sie den angezeigten Programmpfad mit --version aus. Fügen Sie dann genau das in der PATH-Anweisung des Installers genannte Verzeichnis hinzu und öffnen Sie eine neue Shell.

Bei einer normalen Installation ohne Root versucht Anyy, diesen Befehlseinstieg anzulegen:

$HOME/.local/bin/anyy

Der Installer bearbeitet niemals Ihre Shell-Startdateien und ersetzt keinen fremden vorhandenen Befehl anyy.

Was der Installer macht

Der Installer führt diese Schritte der Reihe nach aus:

1. Er erkennt darwin oder linux und ordnet die CPU amd64 oder arm64 zu.
2. Er ermittelt das Anyy-Home-Verzeichnis und die Version.
3. Er setzt eine Installations-/Aktualisierungssperre pro Home, damit nicht zwei Versionsänderungen gleichzeitig laufen.
4. Er prüft erforderliche Befehle sowie verfügbaren temporären Speicher und Platz im Home-Verzeichnis.
5. Er lädt Plattformarchiv und dessen CHECKSUMS.sha256 herunter; begrenzte Downloadfehler werden wiederholt, ohne Teildateien aufzubewahren.
6. Er prüft den SHA-256-Hash des Archivs und lehnt vor der Installation unsichere Archivpfade oder Links ab.
7. Er legt die Programmdatei in einem versionierten Release-Verzeichnis ab und schaltet current atomar darauf um.
8. Er schreibt Metadaten zur Installationsquelle und erstellt einen Befehlseinstieg, sofern dabei keine andere Datei überschrieben wird.
9. Er meldet den installierten Befehl und den Gateway-Status.

Die Installation endet bei der Programmdatei

Die Installation wählt keinen Modellanbieter, schreibt keine config.yaml, erstellt keine state.db und installiert oder startet keinen Hintergrunddienst. Führen Sie anyy setup aus, sobald der Befehl verfügbar ist.

Installationsstruktur

Das Standard-Home hängt vom Benutzer ab, der den Installer ausführt:

Installer-Benutzer	Anyy-Home	Befehlseinstieg
Normaler Benutzer	$HOME/.anyy	$HOME/.local/bin/anyy
root	/root/.anyy	Erstes beschreibbares Verzeichnis aus /usr/local/bin, /opt/homebrew/bin und /usr/bin
Benutzerdefiniertes ANYY_HOME	Der angegebene Pfad	Obiger Einstieg für normalen Benutzer oder Root, der auf dieses Home verweist

Der Installer bereitet diese residente Struktur vor:

<ANYY_HOME>/
├── releases/
│   └── <version>/anyy
├── current -> releases/<version>
├── bin/
│   └── anyy -> ../current/anyy
├── .install/
│   ├── source.json
│   └── previous        # present after a release change when rollback exists
├── backups/
├── cache/
├── logs/
├── memory/
├── scripts/
├── secrets/
├── skills/
├── system/
└── workspace/

Home und vom Installer verwaltete Verzeichnisse werden mit Modus 0700 erstellt; .install/source.json wird mit Modus 0600 geschrieben. Spätere Befehle ergänzen Laufzeit- und Profildateien erst bei Bedarf.

Wenn die Profillaufzeit erstmals ihren dauerhaften Zustand öffnet, erstellt sie auch state.db und den inhaltsadressierten Speicher objects/. Dies sind Laufzeitdaten, keine vom Installer ausgelieferten Dateien.

Die Aktivierung verwendet den Link current, sodass eine abgeschlossene Versionsänderung die aktive Programmdatei in einem Schritt umschaltet. Gibt es eine ältere aktive Version, merkt Anyy sie als Rückkehrziel vor.

Installer-Optionen

Setzen Sie Installer-Optionen am sh-Prozess hinter der Pipe:

Variable	Standard	Verwendung
ANYY_HOME	$HOME/.anyy oder /root/.anyy für Root	Installation in einem anderen Home-Verzeichnis
VERSION	Von https://anyy.ai/releases/latest gelieferte Version	Eine bestimmte verfügbare Version vMAJOR.MINOR.PATCH installieren
ANYY_INSTALL_COMPACT	0	Wenig Speicherplatz und Verlust älterer Rückkehrversionen akzeptabel
ANYY_RELEASE_BASE_URL	https://anyy.ai/releases	Betrieb eines vertrauenswürdigen kompatiblen Release-Spiegels

Ein eigenes Home verwenden

curl -fsSL https://anyy.ai/install.sh | ANYY_HOME="$HOME/.local/share/anyy" sh

Über den installierten Einstieg gestartete Befehle können dieses residente Home ableiten. Sie können weiterhin ausdrücklich --home PATH übergeben, wenn ein Befehl es anbietet.

Eine bestimmte Version installieren

curl -fsSL https://anyy.ai/install.sh | VERSION=v0.1.107 sh

Ersetzen Sie das Beispiel durch einen verfügbaren Release-Tag. VERSION=latest wird nicht akzeptiert; lassen Sie VERSION ungesetzt, um der neuesten veröffentlichten Version zu folgen.

Kompaktmodus bei wenig Speicher verwenden

curl -fsSL https://anyy.ai/install.sh | ANYY_INSTALL_COMPACT=1 sh

Der Kompaktmodus kann den Rückkehrverlauf verkürzen

Der Kompaktmodus bewahrt immer die aktive Version. Er kann inaktive Versionen und nur bei Bedarf zum Bestehen der Home-Speicherprüfung auch das vorherige Rückkehrziel entfernen. Speicherplatz freizugeben ist sicherer, wenn Sie diese Rückkehrmöglichkeit behalten möchten.

Der Release-Quelle vertrauen

Ein eigenes ANYY_RELEASE_BASE_URL liefert sowohl Programmdatei als auch Prüfsummendatei. Verwenden Sie nur eine Quelle, die Sie kontrollieren oder der Sie unabhängig vertrauen.

Neuinstallation und Aktualisierung

Wenn dieselbe Version bereits aktiv ist, repariert ein erneuter Aufruf des offiziellen Installers die internen und Befehlseinstiege von Anyy, ohne die Version herunterzuladen oder zu ersetzen.

Prüfen Sie eine installierte residente Version auf Aktualisierungen mit:

anyy update --check

Verwenden Sie anyy update für den normalen Aktualisierungsablauf. Versionsauswahl, kompakte Aktualisierungen und Rückkehrverhalten sind unter Aktualisierung beschrieben.

Nach der Installation

Fahren Sie mit der interaktiven Einrichtung fort:

anyy setup

Öffnen Sie dann Dashboard:

anyy dashboard

Den vollständigen Ablauf beim ersten Start finden Sie unter Schnellstart. Die eigene Seite Einrichtung erklärt Anbieter- und Modellkonfiguration.

Fehlerbehebung

Symptom	Bedeutung	Vorgehen
unsupported operating system oder unsupported architecture	Für diese Plattform wird keine native Version ausgewählt	Verwenden Sie einen unterstützten macOS- oder Linux-Rechner mit amd64/arm64; natives Windows wird von diesem Installer nicht unterstützt
<command> is required for release install	Ein erforderliches lokales Hilfsprogramm fehlt	Installieren Sie den genannten Befehl und starten Sie den Installer erneut
Preflight failed: not enough ... space	Archiv oder neue Programmdatei passen nicht einschließlich der Sicherheitsreserve des Installers	Geben Sie temporären oder Anyy-Home-Speicher frei und versuchen Sie es erneut; verwenden Sie den Kompaktmodus nur, wenn ein verkürzter Rückkehrverlauf akzeptabel ist
another Anyy install or update is already running	Dasselbe Home ist durch einen anderen Release-Vorgang gesperrt	Warten Sie dessen Abschluss ab und versuchen Sie es erneut
checksum mismatch	Das heruntergeladene Archiv passt nicht zur veröffentlichten Prüfsumme	Wiederholen Sie den Installer; umgehen Sie die Prüfung nicht und aktivieren Sie das Archiv nicht manuell
Command entrypoint already exists and was not replaced	Eine andere Datei oder ein gültiger symbolischer Link belegt den vorgesehenen Befehlspfad	Führen Sie den ausgegebenen Pfad Binary: aus und prüfen und lösen Sie den Befehlskonflikt selbst
anyy: command not found nach erfolgreicher Installation	Das Einstiegsverzeichnis steht nicht im aktuellen PATH	Folgen Sie genau der ausgegebenen PATH-Anweisung, öffnen Sie eine neue Shell und führen Sie anyy --version aus
Gateway: status unavailable	Die installierte Programmdatei konnte den Gateway-Zustand nicht melden	Prüfen Sie die Programmdatei gesondert; führen Sie anyy setup und dann anyy gateway status aus, wenn Sie die residente Laufzeit prüfen möchten
No release was activated.	Die Installation endete vor dem Umschalten auf den Versionskandidaten	Lesen und beheben Sie den vorhergehenden Fehler und versuchen Sie es erneut; eine vorhandene aktive Version wurde durch diesen fehlgeschlagenen Versuch nicht ersetzt