Kurulum

CircuitPal Studio tarayıcıda da çalışır, ama robota bağlanmak ve çevrimdışı kullanmak için masaüstü uygulaması gerekir.

Tek komutla

macOS ve Linux:

ShellTerminal
curl -fsSL https://axion-robot.com/install.sh | bash

Windows (PowerShell):

PowerShellPowerShell
irm https://axion-robot.com/install-app | iex

Betik uygulamayı kurar, isteğe bağlı yerel yapay zekâyı (Ollama + Gemma 4 E4B) kurulu değilse kurar, kuruluysa yeniden indirmez, ve terminale circuitpal-studio komutunu ekler (macOS .pkg paketi de 0.1.5’ten itibaren aynı komutu kurar).

.pkg paketine çift tıklayarak kuranlar, “Kurulum türü” ekranında Yerel yapay zekâ yardımcısı (Cee) kutusunu görür (0.1.6’dan itibaren). Kutu açık kalırsa Studio ilk açılışta Ollama ve Gemma 4 E4B modelini kendi ilerleme ekranıyla indirir (yaklaşık 5,5 GB); zaten kuruluysa bir şey indirmez. Kutuyu kaldırırsan sonra Ayarlar → Yardımcı’dan kurabilirsin. Bu komut uygulamayı açar ve hemen döner; terminal kilitlenmez.

ShellTerminalden açmak
circuitpal-studio
“Bu sistemde betik çalıştırma devre dışı” hatası

Windows internetten gelen betikleri kısıtlar. Yukarıdaki komut diske yazmadan çalıştığı için genelde takılmaz; kurumsal bir cihazda takılırsa yalnız o pencere için izin ver:

PowerShell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Bu kalıcı bir değişiklik değildir; pencereyi kapatınca eski ayara döner.

Betik ne yapıyor

  1. İşletim sistemini ve işlemci mimarisini tanır.
  2. Yayındaki son sürümü sorar.
  3. Kurulum dosyasını indirir ve SHA-256 ile doğrular, özet tutmazsa durur.
  4. Uygulamayı kurar.
  5. İstersen yardımcıyı da kurar; kurmasan da Studio çalışır.

Çalıştırmadan önce okumak istersen indir: install.sh · install.ps1.

Elle indirme

Kurulum dosyalarını ve SHA-256 toplamlarını indirme merkezinde bulabilirsin. İndirdiğin dosyayı doğrulamak için:

ShellSHA-256 doğrulama
macOS / Linux:  shasum -a 256 <dosya>
Windows:        certutil -hashfile <dosya> SHA256

“Bu uygulama açılamıyor” diyorsa

İndirdiğin dosyayı ilk açtığında işletim sistemi bir güvenlik uyarısı gösterebilir. Bilgisayarında bir sorun yok ve dosya bozuk değil. Sebebi şu: uygulamayı imzalayan sertifika henüz Apple’ın ve Microsoft’un “tanınmış yayıncı” listesinde değil. Aşağıdaki adım bir kereliktir; sonraki güncellemelerde tekrar sormaz.

Yukarıdaki tek komutla kurduysan bu bölüm seni ilgilendirmez. Kurulum betiği dosyayı SHA-256 ile doğruladıktan sonra işletim sisteminin “internetten indi” damgasını kendisi kaldırır; uyarı hiç çıkmaz. Aşağısı yalnız kurulum dosyasını elle indirenler için.

macOS

Uyarı şöyle görünür: “circuitpal-studio-….pkg” Not Opened — Apple could not verify … is free of malware. Kutuda yalnız Move to Trash ve Done vardır; “sağ tıkla → Aç” yolu .pkg için yoktur.

  1. Done (Bitti) de. Paketi çöpe atma.
  2. Sistem Ayarları → Gizlilik ve Güvenlik’i aç, sayfayı en alta kaydır.
  3. Paketin adının yanındaki Yine de Aç (Open Anyway) düğmesine bas, Mac parolanı gir. Kurucu bu kez açılır; bir kez yeter.

Terminal yolu iki seçenek. Birincisi paketin “internetten indi” damgasını kaldırır; sonra çift tıklayınca uyarı çıkmaz:

ShellTerminal
xattr -d com.apple.quarantine ~/Downloads/circuitpal-studio-*-arm64.pkg

İkincisi paketi doğrudan kurar (parola sorar). Kurulum bittiğinde uygulama Applications klasöründedir; paket dosyasına yeniden çift tıklamak yine uyarı verir, çünkü uyarı paket dosyasına aittir, kurulan uygulamaya değil:

ShellTerminal
sudo installer -pkg ~/Downloads/circuitpal-studio-*-arm64.pkg -target /
ls /Applications | grep CircuitPal   # kurulduğunu doğrular

Windows

Uyarı şöyle görünür: “Windows bilgisayarınızı korudu” (SmartScreen).

  1. Kutudaki Ek bilgi bağlantısına tıkla.
  2. Altta beliren Yine de çalıştır düğmesine bas.

Emin olmak istersen

Bu adımı atmadan önce indirdiğin dosyanın doğru dosya olduğunu kanıtlayabilirsin: yukarıdaki SHA-256 toplamı indirme merkezinde yazan değerle birebir aynıysa dosya bize ait ve yolda değişmemiştir. Uyarı dosyanın içeriğiyle değil, imzanın türüyle ilgilidir.

Hesap ve lisans

Uygulama açıldığında iki şey ister: hesap ve lisans anahtarı.

  1. Giriş yap. Parola yok: e-postana altı haneli bir kod gelir. Hesabın yoksa ilk kodda kendiliğinden açılır.
  2. Lisans anahtarını gir. Kutunun içinden ya da okulundan gelir. Hesabına bir kez bağlanır ve bir daha sorulmaz.

Ayrıntılar: Hesap ve oturum · Lisans

Sistem gereksinimleri

SistemEn azNot
macOS12 (Monterey)Apple Silicon ve Intel
Windows1064 bit
Linuxglibc 2.31AppImage ya da .deb
TarayıcıChrome / EdgeUSB ile robota bağlanmak için

Yerel yapay zekâ isteğe bağlıdır ve yaklaşık 4 GB indirme ile 8 GB boş bellek ister. Kurmazsan editörün hiçbir özelliği eksilmez.