Bir şey başlamadığında.

A.M.A.R.A. — İlk adımlar ve kurulum

1. Kurulum ve ilk başlatma

1. Ürünler sayfasında 1 günlük ücretsiz denemeyi başlatın ya da satın alın. Polar bunun ardından e-postayla ve müşteri portalında yükleyiciyi ve lisans anahtarını sunar. Oda, etkinleştirilene kadar kapalı kalır.
2. Platformunuza uygun şekilde kurun:
   • Windows: indirilen yükleyiciyi çalıştırın. Kod imzalama sertifikası yeni olduğundan, ilk başlatmada Microsoft Defender SmartScreen yine de uyarabilir — “Daha fazla bilgi” seçeneğini, ardından “Yine de çalıştır” düğmesini seçin.
   • macOS: disk görüntüsünü açın, A.M.A.R.A.’yı Uygulamalar klasörüne sürükleyin ve oradan başlatın. Apple Silicon (M1 veya daha yeni) ve macOS 12 veya daha yenisi gerekir.
   • Linux: .deb paketini kurun (Debian/Ubuntu, x86-64).
3. İlk başlatmada A.M.A.R.A. önce dili, sonra adınızı sorar — asistanlar size böyle hitap eder.
4. Ardından lisans anahtarını yapıştırın ve Activate düğmesine basın (alanın altında Panodan yapıştır, onun altında da anahtarınızı kaybettiyseniz kullanacağınız Anahtarım müşteri portalında bağlantısı bulunur).
5. Anahtar kabul edilmezse oda tam nedeni gösterir:
   • izin verilen 3 bilgisayarın tümünde etkinleştirilmiş — birinde serbest bırakın (Ayarlar → Lisans → Bu bilgisayarı serbest bırak) ya da müşteri portalında halledin;
   • aboneliğiniz sona erdi — yenileme sonrası oda yeniden çalışır, verileriniz ve bu etkinleştirme korunur;
   • geri çekildi (iade veya devre dışı bırakma) — destek ekibinden yardım isteyin;
   • lisans sunucusuna ulaşılamadı — internet bağlantınızı kontrol edip tekrar deneyin.
6. 1 günlük deneme bittiğinde oda “1 günlük testiniz sona erdi” yazar ve aylık aboneliği (istediğiniz zaman iptal edilebilir) ya da ömür boyu lisansı önerir.

2. Bir asistanı nasıl eklerim?

1. Soldaki Asistanlar sekmesini açın. Üstte Bir asistan başlat bölümü görünür.
2. ⌕ Tara düğmesine tıklayın. A.M.A.R.A. bilgisayarınızda kurulu yapay zekâ programlarını arar; bu ilk seferde birkaç saniye sürebilir.
3. Bulunan programların yanındaki Ekle düğmesiyle hangisinin içeri alınacağını seçersiniz. Yalnızca sizin eklediğiniz görünür.
4. Eklenen programlar düğme olarak görünür. Fareyi düğmenin üzerine getirdiğinizde programın bilgisayarda nerede olduğunu ve taramanın onu neden tanıdığını görürsünüz.
5. Bir programın düğmesine tıklayın: kendi sekmesinde, A.M.A.R.A.’nın çalıştırdığı bir terminalde başlar — Windows, macOS ve Linux’ta aynı şekilde.
   • Klasör: burada hangi klasörde çalışacağını belirtebilirsiniz. Boş bırakırsanız kendi klasörünüzde başlar.
   • Hazır olduğunda katılmasını iste: işaretliyse, program başlar başlamaz A.M.A.R.A. programın terminaline kısa bir davet satırı yazar — bunu programın sekmesinde görürsünüz. Bu satır yalnızca program kendi giriş isteminde beklerken yazılır; program önce bir şey sorarsa (örneğin klasöre güvenip güvenmeyeceğiniz, güncelleme yapıp yapmayacağı, oturum açma), bunu sekmede siz yanıtlarsınız. İşaretli değilse daveti sonradan Davet et düğmesiyle gönderirsiniz.
6. Program düğmesinin yanındaki kalem (✎): burada odaya kendi adını ve rengini verirsiniz.

Aynı programdan birden çok örnek de başlatabilirsiniz; oda bunları ayırt eder (“Kimi 2”).

Bir program davete yanıt vermezse (örneğin o sırada çalışıyorsa), odadaki kartında Tekrar davet et düğmesiyle yineleyebilirsiniz. Terminali aç sizi sekmesine geri götürür.

3. Tarama programımı bulamazsa ne olur?

• Yeni kurduysanız Tara düğmesine yeniden basın — yeniden başlatma gerekmez.

• Program kendi terminalinizde başlıyor ama tarama onu bulamıyorsa: bazı yükleyiciler programın klasörünü yalnızca ~/.bashrc (macOS'ta ~/.zshrc) dosyasına yazar ve tarama şu anda bunu okumaz. Bu bilinen bir zayıf noktadır; düzeltme üzerinde çalışıyoruz ve sonraki bir güncelleme bunu çözecek. O zamana kadar siz de çözebilirsiniz: programa ait export PATH=… satırını ~/.profile (macOS'ta ~/.zprofile) dosyasına kopyalayın, A.M.A.R.A.'yı kapatıp yeniden açın ve Tara düğmesine yeniden basın.

• Linux ve macOS’ta (tmux ile) herhangi bir programı terminalde tek bir komutla elle davet edebilirsiniz:

  amara run -- <programın komutu>

  Program kendi tmux oturumunda başlar ve odaya girer. Adı --name, çalışma klasörünü --dir ile verebilirsiniz. Zaten tmux’ta çalışan bir programı içeri almak istiyorsanız o terminalde şunu çalıştırın:

  amara join "<ad>" --any

• Windows’ta şu an yalnızca taramanın tanıdığı programlar eklenebilir.

4. Zaten başka bir pencerede çalışan asistanı nasıl buraya çağırırım?

Asistanlar sekmesinin Bu bilgisayarda başka bir yerde çalışıyor bölümünde, başka bir pencerede başlattığınız asistanları görürsünüz. Hangisinde hangi düğmenin görüneceğini A.M.A.R.A. o programın kendisinden tanır — bu yüzden programa göre farklılık gösterebilir.

• Buraya çağır (diğeri çalışmaya devam eder) — odada aynı konuşmadan yeni bir örnek başlar ve o güne kadarkileri beraberinde getirir. Diğer pencerede çalışan program kendi konuşması üzerinde çalışmaya devam eder. Yalnızca bunu yapabilen programda görünür.
• Buraya çağır ve diğerini kapat — diğer pencerede çalışan programı kapatır ve odada aynı konuşmayı sürdürür. O güne kadarki konuşma kalır; programın o an yaptığı şey kesilir. Öncesinde sorar.
• A.M.A.R.A. diğer pencerede hangi konuşmanın çalıştığını belirleyemezse:
  • Kapat ve klasörün son konuşmasını burada sürdür — klasörün son konuşmasını sürdürür. Bunun aynı olması garanti değildir, bu yüzden önceden uyarır. Aynı klasörde programın başka bir örneği de çalışıyorsa bu başlatılamaz.
  • Kapat ve burada yeni bir konuşma başlat — yeni bir konuşma başlar; eskisi aktarılmaz.

Bir programda hiçbir düğme görünmüyorsa, onu diğer pencerede kapatın ve Bir asistan başlat bölümünden başlatın.

Windows’ta başka bir konsol penceresinde (cmd, PowerShell) çalışan programı ek kurulum olmadan buraya çağırabilirsiniz. Linux ve macOS’ta tmux içinde çalışan asistanlar tmux içinde bulundu listesinde görünür; bunları Ekle ve davet et ya da Yalnızca ekle düğmesiyle alabilirsiniz (bkz. tmux).

Çıkış ve kapatma

• Odadan ayrıl (adındaki ×): asistan odadan çıkar; kendi terminalinde çalışıyorsa orada çalışmaya devam eder ve yeniden odaya dönerse geri gelir.
• Kapat (A.M.A.R.A. tarafından başlatılan sekmede): sekmede çalışan program durur.

5. Linux ve macOS’ta tmux

Linux ve macOS’ta A.M.A.R.A., tmux oturumlarında çalışan asistanları da bulur; bunlar Asistanlar sekmesinin tmux içinde bulundu listesinde görünür.

• Zaten çalışan tmux asistanını Ekle ve davet et ya da Yalnızca ekle düğmesiyle alabilirsiniz.

• Siz de bir terminalde bir tane başlatabilirsiniz; odaya hemen girer:

  amara run -- <programın komutu>

  Adı --name, çalışma klasörünü --dir ile verebilirsiniz. Zaten tmux’ta çalışan programı şöyle de içeri alabilirsiniz:

  amara add

  Odanın o terminale sinyal göndermesini istiyorsanız, orada şunu çalıştırın:

  amara join "<ad>"

• Sekmeyi ya da uygulamayı kapatmak tmux oturumunu yalnızca ayırır: asistan çalışmaya devam eder ve odadan yeniden açabilirsiniz.

6. Windows: başka konsol penceresinde çalışan asistan

Windows’ta bir asistan kendi konsol penceresinde (cmd veya PowerShell) çalışırken, odanın bir sekmesi orada yapılanları canlı olarak yansıtır — böylece bilgisayarınızda zaten süren işi, yeniden başlatmadan odadan izleyebilirsiniz. Oda, Windows’un kendi konsol yönetimiyle diğer pencereye yazar ve onu okur; ek kurulum gerekmez. Çağırma için Ekle ve davet et ya da Buraya çağır… düğmesi kullanılır.

Ancak bu yalnızca taramanın tanıdığı programlar için geçerlidir: “Bu bilgisayarda başka bir yerde çalışıyor” listesine, taramanın asistan olarak tanıdığı programlar girer. Elle ekleme (amara run -- <komut>) Windows’ta kullanılamaz, çünkü tmux’a dayanır — programınız görünmüyorsa Tara düğmesine yeniden basın.

7. Bir şey çalışmıyorsa

• Bir asistan başlamıyor ya da görünmüyorsa, önce durum denetimini çalıştırın:

  amara doctor

  Bu salt okunur bir rapordur — hiçbir şeyi başlatmaz veya değiştirmez ve asla lisans anahtarı, belirteç ya da örnek kimliği yazmaz. Derleme sürümünü, lisans durumunu, amara komutunun yolunu, çıktının kodlamasını ve lisans sunucusuna ulaşılıp ulaşılamadığını gösterir.

• Asistan, odanın adresi için Operation not permitted yazıyorsa, hata odada değildir: program kendi korumalı alanında (sandbox) çalışıyor ve ağı da engelliyor. Ayar şekli, SSS bölümündeki “Aracılarımdan biri odaya ulaşamıyor. Ne yapmalıyım?” sorusunda anlatılıyor.

• Orada Connection refused yazıyorsa oda çalışmıyor demektir: A.M.A.R.A.’yı başlatın.

Bir asistan odada durup yanıt vermiyorsa, çoğu zaman izin bekliyordur. Komut satırı asistanları varsayılan olarak birçok adımdan önce onay ister; odada ise her mesaj bir komuttur. Bu yüzden odanın komutunu onaylamanız, sürekli çalışma içinse tam izni açmanız önerilir. Bu durumda asistan sormadan çalışır; bu nedenle onu yalnızca güvenilir bir klasörde kullanın. Ayar şekli, asistanın kendi belgelerinde anlatılır.