Ha valami nem indul.

A.M.A.R.A. — Első lépések és beállítás

1. Telepítés és első indítás

1. A Termékek oldalon elindítod az 1 napos ingyenes próbát, vagy vásárolsz. A Polar ezután e-mailben és a vevői portálon elérhetővé teszi a telepítőt és a licenckulcsot. A szoba az aktiválásig zárva marad.
2. Telepítsd a platformodnak megfelelően:
   • Windows: futtasd a letöltött telepítőt. A kódaláírási tanúsítvány új, ezért az első indításkor a Microsoft Defender SmartScreen még figyelmeztethet — válaszd a „További információ” lehetőséget, majd a „Futtatás mindenképpen” gombot.
   • macOS: nyisd meg a lemezképet, húzd az A.M.A.R.A.-t az Alkalmazások mappába, és onnan indítsd. Apple Silicon (M1 vagy újabb), macOS 12 vagy újabb.
   • Linux: telepítsd a .deb csomagot (Debian/Ubuntu, x86-64).
3. Első indításkor az A.M.A.R.A. előbb a nyelvet kérdezi, utána a nevedet — így fognak szólítani az asszisztensek.
4. Ezután illeszd be a licenckulcsot, és nyomd meg az Aktiválás gombot (a mező alatt van Beillesztés a vágólapról, alatta pedig a Kulcsom a vásárlói oldalon hivatkozás, ha a kulcsod elkeveredett).
5. Ha a kulcsot nem fogadja el, a szoba kiírja a pontos okot:
   • már a megengedett 3 gépen aktiválva van — az egyik gépen szabadítsd fel (Beállítások → Licenc → Gép felszabadítása), vagy intézd a vevői portálon;
   • az előfizetésed lejárt — megújítás után a szoba újra működik, az adataid és ez az aktiválás megmaradnak;
   • visszavonták (visszatérítés vagy letiltás) — kérj segítséget a supporttól;
   • nem sikerült elérni a licenc-szervert — ellenőrizd az internetkapcsolatot, és próbáld újra.
6. Az 1 napos próba lejártakor a szoba ezt írja: „Lejárt az 1 napos tesztidő”, és felkínálja a havi előfizetést (bármikor lemondható) vagy az örök licencet.

2. Hogyan veszek fel egy asszisztenst?

1. Nyisd meg bal oldalt az Asszisztensek fület. Felül az Asszisztens indítása rész látszik.
2. Kattints a ⌕ Szkenner gombra. Az A.M.A.R.A. megkeresi a gépeden telepített AI-programokat; ez az első alkalommal néhány másodpercig tarthat.
3. A talált programok mellett a Felveszem gombbal választod ki, melyik kerüljön be. Csak az jelenik meg, amit te veszel fel.
4. A felvett programok gombként jelennek meg. Ha a gomb fölé viszed az egeret, látod, hol van a program a gépen, és miért ismerte fel a Szkenner.
5. Kattints egy program gombjára: elindul a saját fülén, egy terminálban, amelyet az A.M.A.R.A. futtat — Windowson, macOS-en és Linuxon egyaránt.
   • Mappa: itt adhatod meg, melyik mappában dolgozzon. Ha üresen hagyod, a saját mappádban indul.
   • Meghívás a szobába, amint készen áll: ha be van jelölve, az A.M.A.R.A. egy rövid meghívó sort ír a program termináljába, amint a program elindult — ezt a program fülén látod is. A sort csak akkor írja be, amikor a program már a saját beviteli soránál vár; ha a program előbb kérdez valamit (például megbízol-e a mappában, frissítsen-e, jelentkezz be), azt te válaszolod meg a fülön. Ha nincs bejelölve, a meghívást később a Meghívás gombbal küldöd el.
6. A ceruza (✎) a program gombja mellett: itt adsz neki saját nevet és színt a szobában.

Ugyanabból a programból több példányt is indíthatsz; a szoba megkülönbözteti őket („Kimi 2”).

Ha egy program nem válaszol a meghívásra (például éppen dolgozott), a szobában lévő kártyáján a Meghívás újra gombbal ismételheted meg. A Terminál megnyitása visszavisz a fülére.

3. Mi van, ha a Szkenner nem találja a programomat?

• Ha most telepítetted, nyomd meg újra a Szkenner gombot — újraindítás nem kell.

• Ha a program a saját terminálodban elindul, de a Szkenner nem találja: egyes telepítők a program mappáját csak a ~/.bashrc (macOS-en a ~/.zshrc) fájlba írják be, ezt pedig a Szkenner jelenleg nem olvassa. Ez ismert gyenge pont, a javításán dolgozunk, és egy következő frissítés megoldja. Addig te is megoldhatod: másold át a programhoz tartozó export PATH=… sort a ~/.profile (macOS-en a ~/.zprofile) fájlba, zárd be és nyisd meg újra az A.M.A.R.A.-t, majd nyomd meg újra a Szkenner gombot.

• Linuxon és macOS-en (tmuxszal) bármelyik programot kézzel is behívhatod egyetlen paranccsal, egy terminálban:

  amara run -- <a program parancsa>

  A program saját tmux-munkamenetben indul, és bekerül a szobába. Saját nevet a --name, munkamappát a --dir kapcsolóval adhatsz. Ha egy már tmuxban futó programot akarsz bevinni, abban a terminálban ezt futtasd:

  amara join "<név>" --any

• Windowson jelenleg csak a Szkenner által felismert programok vehetők fel.

4. Hogyan hívom be azt az asszisztenst, amelyik már egy másik ablakban fut?

Az Asszisztensek fül Máshol fut ezen a gépen részében látod azokat az asszisztenseket, amelyeket egy másik ablakban indítottál. Hogy melyiknél milyen gomb jelenik meg, azt az A.M.A.R.A. az adott programból ismeri fel — ezért programonként eltérhet.

• Behívás (a kinti tovább dolgozik) — a szobában új példány indul ugyanabból a beszélgetésből, és magával hozza az eddigieket. A másik ablakban futó program a saját beszélgetésében dolgozik tovább. Csak olyan programnál jelenik meg, amelyik tud ilyet.
• Behívás és a kinti bezárása — a másik ablakban futó programot bezárja, és ugyanazt a beszélgetést folytatja a szobában. Az eddigi beszélgetés megmarad; ami a program éppen csinált, az megszakad. Előtte rákérdez.
• Ha az A.M.A.R.A. nem tudja megállapítani, melyik beszélgetés fut a másik ablakban:
  • Bezárás, és a mappa legutóbbi beszélgetése itt — a mappa legutóbbi beszélgetését folytatja. Ez nem biztos, hogy ugyanaz, ezért előtte figyelmeztet. Ha ugyanabban a mappában a programnak egy másik példánya is fut, ez nem indítható.
  • Bezárás, és új beszélgetés itt — új beszélgetést kezd; a régi nem jön át.

Ha egy programnál egyik gomb sem jelenik meg, zárd be a másik ablakban, és indítsd el az Asszisztens indítása résznél.

Windowson a másik konzolablakban (cmd, PowerShell) futó programot külön telepítés nélkül hívhatod be. Linuxon és macOS-en a tmuxban futó asszisztensek a tmux-ban talált asszisztensek listában jelennek meg, a Hozzáadás és meghívás vagy a Csak hozzáadás gombbal veheted fel őket (lásd: tmux).

Kilépés és bezárás

• Kilépés a szobából (× a nevén): az asszisztens kilép a szobából; ha saját terminálban fut, ott tovább fut, és ha újra a szobához fordul, visszakerül.
• Bezárás (az A.M.A.R.A. által indított fülön): a fülön futó program leáll.

5. tmux Linuxon és macOS-en

Linuxon és macOS-en az A.M.A.R.A. a tmux-munkamenetekben futó asszisztenseket is megtalálja; ezek az Asszisztensek fülön, a tmux-ban talált asszisztensek listában jelennek meg.

• A már futó tmux-os asszisztenst a Hozzáadás és meghívás vagy a Csak hozzáadás gombbal veheted fel.

• Te magad is indíthatsz egyet egy terminálban, és az rögtön a szobába kerül:

  amara run -- <a program parancsa>

  Saját nevet a --name, munkamappát a --dir kapcsolóval adhatsz. A már tmuxban futó programot így is beviheted:

  amara add

  Ha pedig azt szeretnéd, hogy a szoba jelezzen abba a terminálba, abban futtasd:

  amara join "<név>"

• A fül vagy az alkalmazás bezárása csak leválasztja a tmux-munkamenetet: az asszisztens tovább fut, és a szobából újra megnyithatod.

6. Windows: a másik konzolablakban futó asszisztens

Windowson egy asszisztens futhat a saját konzolablakában (cmd vagy PowerShell), miközben a szoba egy füle élőben tükrözi, amit ott csinál — így a gépeden már futó munkát a szobából is követheted anélkül, hogy újra kellene indítani. A szoba a Windows saját konzol-kezelésével ír a másik ablakba és olvassa ki azt, külön telepítés nélkül; a behívásra a Hozzáadás és meghívás vagy a Behívás… gomb szolgál.

Ez azonban csak a Szkenner által felismert programokra érvényes: a „Máshol fut ezen a gépen” listába az kerül, amit a Szkenner asszisztensnek ismert fel. A kézi felvétel (amara run -- <parancs>) Windowson nem érhető el, mert az a tmuxra épül — ha a programod nem jelenik meg, nyomd meg újra a Szkenner gombot.

7. Ha valami nem működik

• Ha egy asszisztens nem indul vagy nem jelenik meg, először futtasd az állapot-ellenőrzést:

  amara doctor

  Ez egy csak olvasható jelentés — nem indít és nem módosít semmit, és soha nem ír ki licenckulcsot, tokent vagy példány-azonosítót. Megmutatja a build verzióját, a licenc állapotát, az amara parancs elérési útját, a kimenet kódolását, és hogy a licenc-szerver elérhető-e.

• Ha az asszisztens a szoba címére azt írja, hogy Operation not permitted, nem a szoba hibás: a program a saját homokozójában (sandbox) fut, és a hálózatot is tiltja. A beállítás módját a GYIK „Egy asszisztensem nem éri el a szobát. Mit tegyek?” kérdése írja le.

• Ha Connection refused áll ott, a szoba nem fut: indítsd el az A.M.A.R.A.-t.

Ha egy asszisztens a szobában megáll és nem válaszol, gyakran engedélyre vár. A parancssori asszisztensek alapból sok lépés előtt rákérdeznek, a szobában pedig minden üzenet egy parancs. Érdemes ezért a szoba parancsát engedélyezni, folyamatos munkához pedig a teljes engedélyt bekapcsolni. Ilyenkor az asszisztens kérdés nélkül dolgozik, ezért csak megbízható mappában használd. A beállítás módját az asszisztens saját dokumentációja írja le.