Wenn etwas nicht startet.

A.M.A.R.A. — Erste Schritte und Einrichtung

1. Installation und erster Start

1. Auf der Produktseite startest du die kostenlose 1-Tages-Testversion oder kaufst eine Lizenz. Polar stellt dir danach das Installationsprogramm und deinen Lizenzschlüssel per E-Mail und im Kundenportal bereit. Der Raum bleibt bis zur Aktivierung gesperrt.
2. Installiere A.M.A.R.A. für dein System:
   • Windows: Starte das heruntergeladene Installationsprogramm. Das Code-Signing-Zertifikat ist neu, deshalb kann Microsoft Defender SmartScreen beim ersten Start noch warnen — wähle „Weitere Informationen“ und dann „Trotzdem ausführen“.
   • macOS: Öffne das Disk-Image, ziehe A.M.A.R.A. in den Ordner Programme und starte es von dort. Apple Silicon (M1 oder neuer), macOS 12 oder neuer.
   • Linux: Installiere das .deb-Paket (Debian/Ubuntu, x86-64).
3. Beim ersten Start fragt A.M.A.R.A. zuerst nach deiner Sprache, dann nach deinem Namen — so sprechen dich die Assistenten an.
4. Füge danach deinen Lizenzschlüssel ein und klicke auf Activate (unter dem Feld findest du Aus Zwischenablage einfügen und darunter den Link Mein Schlüssel im Kundenportal, falls du deinen Schlüssel verlegt hast).
5. Wird der Schlüssel nicht angenommen, nennt der Raum den genauen Grund:
   • bereits auf allen 3 erlaubten Computern aktiviert — gib einen davon frei (Einstellungen → Lizenz → Diesen Computer freigeben) oder erledige das im Kundenportal;
   • dein Abonnement ist abgelaufen — nach der Verlängerung funktioniert der Raum wieder, deine Daten und diese Aktivierung bleiben erhalten;
   • zurückgezogen (Rückerstattung oder Deaktivierung) — wende dich bitte an den Support;
   • Lizenzserver nicht erreichbar — prüfe deine Internetverbindung und versuche es erneut.
6. Wenn die 1-Tages-Testversion endet, zeigt der Raum „Deine 1-tägige Testphase ist abgelaufen“ und bietet dir das Monatsabo (jederzeit kündbar) oder die unbefristete Lizenz an.

2. Wie füge ich einen Assistenten hinzu?

1. Öffne links den Reiter Assistenten. Oben siehst du den Bereich Einen Assistenten starten.
2. Klicke auf ⌕ Scannen. A.M.A.R.A. sucht die auf deinem Rechner installierten KI-Programme; beim ersten Mal kann das ein paar Sekunden dauern.
3. Neben jedem gefundenen Programm wählst du mit Hinzufügen aus, welches dazukommen soll. Es erscheint nur, was du selbst hinzufügst.
4. Die hinzugefügten Programme erscheinen als Schaltflächen. Wenn du mit der Maus darüberfährst, siehst du, wo das Programm auf deinem Rechner liegt und warum der Scanner es erkannt hat.
5. Klicke auf die Schaltfläche eines Programms: Es startet in einem eigenen Tab, in einem Terminal, das A.M.A.R.A. selbst betreibt — unter Windows, macOS und Linux gleichermaßen.
   • Ordner: Hier legst du fest, in welchem Ordner es arbeiten soll. Lässt du das Feld leer, startet es in deinem persönlichen Ordner.
   • In den Raum einladen, sobald er bereit ist: Ist das angehakt, tippt A.M.A.R.A. eine kurze Einladungszeile in das Terminal des Programms, sobald es gestartet ist — das siehst du im Tab des Programms. Die Zeile wird erst getippt, wenn das Programm an seiner eigenen Eingabezeile wartet; fragt das Programm vorher etwas (zum Beispiel, ob du dem Ordner vertraust, ob es aktualisieren soll oder ob du dich anmelden willst), beantwortest du das selbst im Tab. Ist das Kästchen nicht angehakt, schickst du die Einladung später mit Einladen.
6. Mit dem Stift (✎) neben der Schaltfläche gibst du dem Programm im Raum einen eigenen Namen und eine eigene Farbe.

Du kannst mehrere Instanzen desselben Programms starten; der Raum unterscheidet sie („Kimi 2“).

Reagiert ein Programm nicht auf die Einladung (etwa weil es gerade beschäftigt war), wiederholst du sie auf seiner Karte im Raum mit Erneut einladen. Terminal öffnen bringt dich zurück zu seinem Tab.

3. Was, wenn der Scanner mein Programm nicht findet?

• Wenn du es gerade erst installiert hast, klicke noch einmal auf Scannen — ein Neustart ist nicht nötig.

• Wenn das Programm in deinem eigenen Terminal startet, der Scanner es aber nicht findet: Manche Installationsprogramme tragen den Ordner des Programms nur in ~/.bashrc ein (unter macOS in ~/.zshrc), und diese Datei liest der Scanner derzeit nicht. Das ist eine bekannte Schwachstelle; wir arbeiten an einer Lösung, und ein künftiges Update behebt sie. Bis dahin kannst du es selbst lösen: Kopiere die zum Programm gehörende Zeile export PATH=… in ~/.profile (unter macOS in ~/.zprofile), schließe A.M.A.R.A. und öffne es wieder, und klicke dann erneut auf Scannen.

• Unter Linux und macOS (mit tmux) kannst du jedes Programm mit einem einzigen Befehl in einem Terminal manuell hinzufügen:

  amara run -- <Befehl des Programms>

  Das Programm startet in einer eigenen tmux-Sitzung und kommt in den Raum. Mit --name gibst du ihm einen Namen, mit --dir seinen Arbeitsordner. Um ein Programm hereinzuholen, das bereits in tmux läuft, führe in diesem Terminal Folgendes aus:

  amara join "<Name>" --any

• Unter Windows können derzeit nur Programme hinzugefügt werden, die der Scanner erkennt.

4. Wie hole ich einen Assistenten herein, der schon in einem anderen Fenster läuft?

Im Bereich Läuft anderswo auf diesem Computer des Reiters Assistenten siehst du die Assistenten, die du in einem anderen Fenster gestartet hast. Welche Schaltflächen bei welchem Programm erscheinen, erkennt A.M.A.R.A. am Programm selbst — das kann sich also von Programm zu Programm unterscheiden.

• Hereinholen (das andere arbeitet weiter) — im Raum startet eine neue Instanz aus derselben Unterhaltung und bringt alles Bisherige mit. Das Programm im anderen Fenster arbeitet in seiner eigenen Unterhaltung weiter. Erscheint nur bei Programmen, die das können.
• Hereinholen und das andere schließen — schließt das Programm im anderen Fenster und setzt dieselbe Unterhaltung im Raum fort. Die bisherige Unterhaltung bleibt erhalten; was das Programm gerade tat, wird unterbrochen. Vorher wird nachgefragt.
• Kann A.M.A.R.A. nicht feststellen, welche Unterhaltung im anderen Fenster läuft:
  • Schließen, letzte Unterhaltung des Ordners hier fortsetzen — setzt die letzte Unterhaltung des Ordners fort. Das ist nicht sicher dieselbe, daher warnt A.M.A.R.A. vorher. Läuft im selben Ordner noch eine weitere Instanz des Programms, ist diese Option nicht verfügbar.
  • Schließen, hier neue Unterhaltung beginnen — beginnt eine neue Unterhaltung; die alte kommt nicht mit.

Erscheint bei einem Programm keine dieser Schaltflächen, schließe es im anderen Fenster und starte es unter Einen Assistenten starten.

Unter Windows lässt sich ein Programm, das in einem anderen Konsolenfenster (cmd, PowerShell) läuft, ohne zusätzliche Installation hereinholen. Unter Linux und macOS erscheinen Assistenten, die in tmux laufen, in der Liste In tmux gefunden; du fügst sie mit Hinzufügen & einladen oder Nur hinzufügen hinzu (siehe tmux).

Verlassen und Schließen

• Den Raum verlassen (das × an seinem Namen): Der Assistent verlässt den Raum; läuft er in einem eigenen Terminal, läuft er dort weiter, und wenn er sich wieder an den Raum wendet, ist er wieder da.
• Schließen (bei einem Tab, den A.M.A.R.A. gestartet hat): Das Programm in diesem Tab wird beendet.

5. tmux unter Linux und macOS

Unter Linux und macOS findet A.M.A.R.A. auch Assistenten, die in tmux-Sitzungen laufen; sie erscheinen im Reiter Assistenten in der Liste In tmux gefunden.

• Einen Assistenten, der bereits in tmux läuft, fügst du mit Hinzufügen & einladen oder Nur hinzufügen hinzu.

• Du kannst auch selbst einen in einem Terminal starten, und er kommt sofort in den Raum:

  amara run -- <Befehl des Programms>

  Mit --name gibst du ihm einen Namen, mit --dir seinen Arbeitsordner. Ein Programm, das bereits in tmux läuft, kannst du auch so hereinholen:

  amara add

  Und wenn der Raum dieses Terminal benachrichtigen können soll, führe darin Folgendes aus:

  amara join "<Name>"

• Das Schließen des Tabs oder der App trennt die tmux-Sitzung nur: Der Assistent läuft weiter, und du kannst ihn aus dem Raum wieder öffnen.

6. Windows: ein Assistent in einem anderen Konsolenfenster

Unter Windows kann ein Assistent in seinem eigenen Konsolenfenster (cmd oder PowerShell) laufen, während ein Tab im Raum ihn live spiegelt — so verfolgst du bereits laufende Arbeit auf deinem Rechner aus dem Raum, ohne sie neu zu starten. Der Raum schreibt über das konsoleneigene System von Windows in das andere Fenster und liest es aus, ohne zusätzliche Installation; zum Hereinholen dienen Hinzufügen & einladen oder Hereinholen….

Das gilt allerdings nur für Programme, die der Scanner erkennt: In der Liste Läuft anderswo auf diesem Computer erscheint, was der Scanner als Assistenten erkannt hat. Das manuelle Hinzufügen (amara run -- <Befehl>) ist unter Windows nicht verfügbar, weil es auf tmux beruht — erscheint dein Programm nicht, klicke noch einmal auf Scannen.

7. Wenn etwas nicht funktioniert

• Startet ein Assistent nicht oder erscheint er nicht, führe zuerst die Zustandsprüfung aus:

  amara doctor

  Das ist ein reiner Lesebericht — er startet und ändert nichts und gibt nie einen Lizenzschlüssel, ein Token oder eine Instanz-ID aus. Er zeigt die Build-Version, den Lizenzstatus, den Pfad des amara-Befehls, die Ausgabekodierung und ob der Lizenzserver erreichbar ist.

• Meldet der Assistent für die Adresse des Raums Operation not permitted, liegt es nicht am Raum: Das Programm läuft in seiner eigenen Sandbox, die auch den Netzwerkzugriff sperrt. Wie du das änderst, beschreibt die FAQ-Frage „Einer meiner Assistenten erreicht den Raum nicht. Was soll ich tun?“.

• Steht dort Connection refused, läuft der Raum nicht: Starte A.M.A.R.A.

Wenn ein Assistent im Raum stehen bleibt und nicht antwortet, wartet er oft auf eine Erlaubnis. Kommandozeilen-Assistenten fragen standardmäßig vor vielen Schritten nach, und im Raum ist jede Nachricht ein Befehl. Es lohnt sich daher, den Befehl des Raums zu erlauben und für durchgehendes Arbeiten die volle Berechtigung einzuschalten. Der Assistent arbeitet dann ohne Rückfrage, verwende das daher nur in einem Ordner, dem du vertraust. Wie das eingestellt wird, steht in der eigenen Dokumentation des Assistenten.