# Kurulum (Installation) Headless AugeLab Studio'nun kurulumu işletim sisteminize göre değişir. Aşağıdaki talimatları kendi platformunuz için takip edin. ## Windows AugeLab Studio yükleyicisini kullanmak, headless çalışma zamanını manuel olarak zaten kurar ve Windows'ta Headless Studio kurmak için önerilen yöntemdir. ## Linux Linux yükleyici betiğini [account.augelab.com](https://account.augelab.com) adresinden indirin. Yükleyici, Debian ve Debian tabanlı dağıtımları (Ubuntu dahil) destekler. `~/studio_venv` altında izole bir sanal ortam oluşturur, seçilen `studio` paket profilini kurar ve UI modu seçildiğinde masaüstü başlatıcıları oluşturur. {% hint style="warning" %} Yükleyici NVIDIA CUDA Toolkit veya NVIDIA sürücülerini kurmaz. AI/GPU modu için önce makineye doğru NVIDIA sürücüsünü ve **CUDA 12.8**'i kurun. {% endhint %} ### Tam kurulum Normal masaüstü + headless kurulumu için şu komutları kullanın: ```bash chmod +x installer.sh ./installer.sh --ui ``` Bu, `studio[ui]` paketini kurar, `~/studio_venv` oluşturur, `augelab_studio` başlatıcısını ekler ve masaüstü girdileri oluşturur. Kurulumdan sonra çalıştırın: ```bash augelab_studio ``` ### AI/GPU desteği ile tam kurulum Önce NVIDIA sürücüsünü ve **CUDA 12.8**'i kurun. Ardından şu komutları çalıştırın: ```bash chmod +x installer.sh ./installer.sh --ui --ai ``` Bu, `studio[ui,gpu]` paketini kurar.
Sadece Headless Sadece Python API'sine ihtiyacınız varsa ve masaüstü UI'ye gerek yoksa bunu kullanın: ```bash chmod +x installer.sh ./installer.sh --headless ``` Bu `studio` paketini kurar. UI başlatıcısı ve masaüstü girdileri oluşturulmaz.
AI/GPU desteği ile Headless Önce NVIDIA sürücüsünü ve **CUDA 12.8**'i kurun. Ardından: ```bash chmod +x installer.sh ./installer.sh --headless --ai ``` Bu `studio[gpu]` paketini kurar. UI başlatıcısı ve masaüstü girdileri oluşturulmaz.
Etkileşimli kurulum Kurucu betiğini mod bayrakları olmadan çalıştırarak kurulum modunu etkileşimli seçebilirsiniz: ```bash chmod +x installer.sh ./installer.sh ``` Yükleyici önce headless mi yoksa UI modu mu kurulacağını, sonra AI/GPU ekstra paketinin dahil edilip edilmeyeceğini sorar.
Ortam değişkenleri ile etkileşimsiz kurulum Otomasyondan çalıştırırken ortam değişkenleri kullanın: ```bash INSTALL_UI=1 INSTALL_AI=0 ./installer.sh INSTALL_UI=1 INSTALL_AI=1 ./installer.sh INSTALL_UI=0 INSTALL_AI=0 ./installer.sh INSTALL_UI=0 INSTALL_AI=1 ./installer.sh ``` `INSTALL_UI=1` UI modunu seçer. `INSTALL_AI=1` AI/GPU ekstrasını dahil eder.
Kaldırma (Uninstall) ```bash ./installer.sh --uninstall ``` Bu komut yükleyici tarafından oluşturulan dosyaları kaldırır: * `~/studio_venv` * `~/.local/bin/augelab_studio` * AugeLab Studio masaüstü girdileri * AugeLab Studio simgeleri Üst dizinler yalnızca boşlarsa kaldırılır.
Manuel Python kurulumu Mümkünse yükleyiciyi kullanın. Manuel bir Python ortamına ihtiyacınız varsa, sistem Python'u yerine izole bir sanal ortama kurulum yapın: ```bash apt-get update -y && \ apt-get install -y --no-install-recommends \ libdmtx0b \ zbar-tools \ build-essential \ libgl1-mesa-glx \ curl \ ca-certificates \ && rm -rf /var/lib/apt/lists/* curl -fsSL https://astral.sh/uv/install.sh | sh uv venv -p 3.12 studio_venv uv pip install --python studio_venv/bin/python \ studio \ --extra-index-url https://pyrepo.augelab.com \ --extra-index-url https://download.pytorch.org/whl/cpu \ --index-strategy unsafe-best-match ``` AI/GPU için manuel kurulum yapıyorsanız önce NVIDIA sürücüsünü ve **CUDA 12.8**'i kurun, ardından `studio` yerine `studio[gpu]` kullanın.
## x86\_64 için CPU/CUDA ile Docker Müşteri dağıtımları için konteyner görüntüsünü bir Dockerfile'dan oluşturun. AugeLab Studio kapalı kaynak bir uygulamadır; bu yüzden Docker, Studio'yu kaynak koddan derlemek yerine AugeLab paket indeksinden `studio` paketini kurar. Standart Docker kılavuzu için [Docker Example](/turkish/one-cikan-ozellikler/headless/docker-example.md) dosyasını kullanın. İçerdiği öğeler: * CPU Dockerfile * GPU/CUDA Dockerfile * `docker-compose.yml` * `.env` * senaryo çalıştırıcı betiği * bağlanan çıktı klasörü ### CPU Docker Senaryonuz CUDA hızlandırmasına ihtiyaç duymuyorsa CPU Docker kullanın. Docker örneği `python:3.12-slim-bookworm` tabanından derlenir ve `studio` paketini kurar. ### GPU/CUDA AugeLab Studio, headless senaryolar için CUDA hızlandırmasını destekler. GPU Docker, host üzerinde uyumlu NVIDIA sürücüleri ve NVIDIA Container Toolkit gerektirir. GPU/CUDA Dockerfile için [Docker Example](/turkish/one-cikan-ozellikler/headless/docker-example.md) içindeki GPU Dockerfile'ı kullanın. Bu, bir NVIDIA CUDA runtime görüntüsünden oluşturur ve `studio[gpu]` paketini kurar. ## ARM64 (Raspberry Pi, Jetson Nano/AGX) AugeLab Studio, Raspberry Pi ve NVIDIA Jetson serisi gibi Debian tabanlı cihazlarda headless kullanım için ARM64 mimarisini destekler. Linux ARM64 yükleyici betiklerini [account.augelab.com](https://account.augelab.com) adresinden indirin ve ardından cihazda yükleyiciyi çalıştırın. ### Tam ARM64 kurulumu ```bash chmod +x installer.sh ./installer.sh --ui ``` Bu, `studio[ui]` paketini kurar, `~/studio_venv` oluşturur, `augelab_studio` başlatıcısını ekler ve masaüstü girdileri oluşturur. ### AI/GPU desteği ile tam ARM64 kurulumu Önce cihazınız için doğru NVIDIA JetPack/CUDA yığınına uygun kurulum yapın. Jetson cihazları için JetPack sürümünüzle eşleşen CUDA sürümünü kullanın. ```bash chmod +x installer.sh ./installer.sh --ui --ai ``` Bu, `studio[ui,gpu]` paketini kurar.
Sadece Headless ARM64 ```bash chmod +x installer.sh ./installer.sh --headless ``` Bu `studio` paketini kurar. UI başlatıcısı ve masaüstü girdileri oluşturulmaz.
AI/GPU desteği ile Headless ARM64 Önce cihazınız için doğru NVIDIA JetPack/CUDA yığınına uygun kurulum yapın. Jetson cihazları için JetPack sürümünüzle eşleşen CUDA sürümünü kullanın. ```bash chmod +x installer.sh ./installer.sh --headless --ai ``` Bu `studio[gpu]` paketini kurar. UI başlatıcısı ve masaüstü girdileri oluşturulmaz.
ARM64 kaldırma ```bash ./installer.sh --uninstall ```
{% hint style="info" %} ARM64 yükleyici Debian ve Debian tabanlı dağıtımları destekler. Cihazınız başka bir Linux ailesi kullanıyorsa, dağıtım rehberliği için AugeLab ile iletişime geçin. {% endhint %} Jetson GPU/CUDA dağıtımlarında, yükleyici, JetPack, CUDA yığını ve cihazınız için uygun AugeLab paket profili arasında uyum olduğundan emin olun. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.augelab.com/turkish/one-cikan-ozellikler/headless/installation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.