Adaptea'yı kullanmaya başlayın

Adaptea, yerel kodlama ajanları için geliştirilmiş bir orkestratördür. Yerel çıkarım motorlarınıza (LM Studio, Ollama, llama.cpp veya vLLM) OpenCode üzerinden bağlanır; ardından işi planlar, zamanlar, doğrular ve deponuza bütünleştirir. Hem yerel masaüstü uygulaması hem de klavye odaklı terminal arayüzü aynı Python çekirdeğini ve kalıcı .adaptea durumunu paylaşır.

Tasarımı gereği tamamen yerel

Kod deponuz, kod değişiklikleri, istemleriniz, model ağırlıkları ve tüm çalışma çıktıları makinenizde kalır. Adaptea bulut API'lerine asla bağımlı değildir.

Doğru masaüstü sürümünü seçin

İşletim sisteminin adı aynı olsa bile işlemci mimarisi önemlidir. Mevcut herkese açık beta aşağıdaki masaüstü yükleyicilerini sunar:

MEVCUTMac · Apple siliconM1, M2, M3, M4 veya daha yeni · ARM64 · macOS 12+

MEVCUTMac · Intelx86_64 Mac modelleri · macOS 12+

YAKINDAWindows · Intel veya AMD64 bit x64 masaüstü yükleyicisi geliştirme aşamasında; çok yakında.

YAKINDAWindows · ARM64ARM64 Snapdragon masaüstü yükleyicisi geliştirme aşamasında; çok yakında.

Mac'te Apple menüsü → Bu Mac Hakkında'yı açın. Apple M ile başlayan “Çip” alanı Apple silicon, Intel ile başlayan “İşlemci” alanı Intel demektir. Windows masaüstü sürümleri çok yakında kullanıma sunulacaktır.

Gereksinimler

Adaptea ile kodlama çalıştırmaları başlatmadan önce (masaüstü veya CLI) makinenizde şu ön koşulların hazır olduğundan emin olun:

Yalıtılmış görev çalışma ağaçları ve otomatik dal birleştirme için Git
Yerel Çıkarım Motoru: En az bir modelle yerel çalışan LM Studio, Ollama, llama.cpp (llama-server) veya vLLM
Kodlama ajanı çalışma motoru olarak OpenCode
En az 32K bağlam; planlama için 65.536 token kuvvetle önerilir

Adaptea'nın Ortam sayfası ve adaptea doctor komutu bu katmanları sırasıyla denetler; bir eksiklik varsa doğrudan uygulanabilir çözümü gösterir.

İlk çalıştırmanız

1
Bir proje klasörü açın
Adaptea siz açıkça açmadan veya içinde komut çalıştırmadan hiçbir depoyu okumaz.
2
Ortam kurulumunu tamamlayın
Çıkarım altyapısını ve modelleri seçin; LM Studio uyarlanabilir zamanlamasını kullanıyorsanız kalibrasyonu çalıştırın.
3
Bir iş başlatın
Hedefi doğal dille anlatın, ardından oluşturulan bağımlılık planını inceleyip düzenleyin.
4
Çalıştırma modunu seçin
LM Studio için normal seçim Uyarlanabilir'dir. Kontrol ve karşılaştırma için Seri, Sabit ve Naif modları da vardır.
5
Sonucu inceleyin
Geçen görevler bütünleştirme dalında birleştirilir ve tek bir squash commit olarak projenize uygulanabilir.

Terminal kurulumu ve güncellemeler

Adaptea'nın terminal sürümü eksiksiz bir klavye odaklı deneyim sunar. Masaüstü uygulamasıyla aynı Python servislerini çalıştırır, birebir aynı zamanlama algoritmalarını kullanır ve aynı kalıcı .adaptea çalışma durumunu okur/yazar.

Tek satırlık hızlı kurucu (macOS ve Linux)

macOS veya Linux ortamında Git'i kurduktan sonra otomatik kurulum betiğini çalıştırın:

macOS veya Linux terminali · latest

curl -LsSf https://adaptea.dev/install.sh | sh

Kurulum betiği yalıtılmış bir Python 3.12 çalışma ortamı hazırlar ve en güncel etiketli sürümü kurar. Python veya uv paket yöneticisini elle yönetmenize gerek kalmaz. Adaptea'yı güncellemek için aynı komutu dilediğiniz zaman yeniden çalıştırmanız yeterlidir.

uv ile kaynaktan kurulum (Tüm platformlar)

Geliştiriciler veya hazır ikili paketi bulunmayan platformlar (Intel Mac, Linux sunucular ve Windows PowerShell) için:

Kaynak kodu klonlama & uv kurulumu

git clone https://github.com/tahaenesaslanturk/Adaptea-Core.git
cd Adaptea-Core
uv sync
uv run adaptea --version

Etkileşimli REPL ve TUI paneli

Adaptea, kullanım tercihinize göre iki güçlü terminal arayüzü sağlar:

adapteaEtkileşimli REPL

Hızlı etkileşimli komut merkezini açar. Komut satırından ayrılmadan proje seçebilir, kurulumu çalıştırabilir, tanıları inceleyebilir, modelleri kalibre edebilir ve görev yürütebilirsiniz.

adaptea --dashboardTam Ekran TUI

Textual ile geliştirilmiş tam ekran widget panelini (kısayol: adaptea tui) başlatır. Canlı ajan yuvalarını, yük grafiklerini, kuyruk durumunu ve çalışma günlüklerini anlık görüntüler.

Terminal arayüz komutları

# Etkileşimli komut REPL'i
adaptea

# Tam ekran canlı izleme paneli (TUI)
adaptea --dashboard

Kurulum, sistem denetimi & duman testi

Büyük bir yazılım geliştirme görevine başlamadan önce Adaptea, çıkarım sunucunuzun, modellerinizin ve Git ortamınızın eksiksiz olduğunu denetleyen araçlar sunar.

Etkileşimli Kurulum Merkezi (`adaptea setup`)

Kurulum merkezi makinenizi inceler ve gerekli düzeltmeleri adım adım yönlendirir: LM Studio, Ollama, llama.cpp veya vLLM'i tespit eder, yerel sunucu durumunu doğrular, bağlam uzunluklarını kontrol eder ve OpenCode'u projeye özel yapılandırır.

Kurulum merkezi

# Adım adım etkileşimli kurulum
adaptea setup

# Güvenli adımları otomatik uygula (indirmeler için onay ister)
adaptea setup --auto

# Canlı alt işlem çıktılarını ve günlükleri göster
adaptea setup --verbose

Tanısal Sistem Denetimi (`adaptea doctor`)

Sistem araçlarını, çıkarım uç noktalarını, yüklenen model bağlam boyutunu (en az 32.768+ token), proje ayarlarını ve kapasite durumunu zarar vermeden denetler:

Tanı denetimini çalıştır

adaptea doctor

Deterministik MVP Duman Testi (`adaptea smoke-test`)

Zamanlayıcı, çalışma ağaçları, ajanlar, doğrulama ve birleştirme hattının tamamını geçici ve deterministik bir Git deposunda test eder. Gerçek projenize dokunmadan model yanıtlarını ve kod birleştirmeyi doğrular:

Duman testi

# Uçtan uca boru hattını doğrula
adaptea smoke-test

# İncelemek üzere geçici test klasörünü sakla
adaptea smoke-test --keep-fixture

Planlama, çalıştırma ve devam etme

Adaptea karmaşık geliştirme hedeflerini bağımlılıkları gözetilmiş bir görev grafiğine böler, hazır görevleri yalıtılmış Git çalışma ağaçlarında paralel çalıştırır, test komutunuzla onaylar ve temiz tek bir commit olarak birleştirir.

1. Bağımlılık planı oluşturma (`adaptea plan`)

OpenCode ve yerel modelinizden doğrulanmış bir görev dağılımı ister ve planı .adaptea/runs/plan-<tarih>-<id>/plan.json konumuna kaydeder:

Geliştirme hedefini planla

adaptea plan "Giriş, kayıt, şifre sıfırlama ve birim testleri içeren kimlik doğrulama modülü geliştir"

2. Bir çalıştırma başlatma (`adaptea run`)

Doğrudan doğal dille hedef vererek çalıştırabilir ya da incelenmiş bir plan.json dosyası geçebilirsiniz. Donanımınıza uygun kabul zamanlayıcısını belirleyin:

Zamanlayıcı	CLI Parametresi	Davranış ve Önerilen Kullanım
Uyarlanabilir (Adaptive)	`--scheduler adaptive`	(LM Studio için varsayılan) Canlı kuyruk derinliğini ve üretim yükünü izler. Kaynak varsa yeni ajan kabul eder, yoğunlukta bekletir.
Sabit (Fixed)	`--scheduler fixed --concurrency <N>`	Aynı anda çalışacak sabit ajan sınırını korur (örn. `--concurrency 4`). Kontrollü karşılaştırmalar için uygundur.
Naif (Naive)	`--scheduler naive --max-agents <N>`	Sunucu yükünü kontrol etmeden tüm hazır görevleri tavan sınıra kadar aynı anda başlatır.

Çalıştırma komutları

# Doğal dille verilen hedeften uyarlanabilir çalıştırma
adaptea run "Karanlık mod desteği ve birim testleri olan kullanıcı paneli oluştur"

# İncelenmiş plan dosyasından çalıştırma
adaptea run --plan .adaptea/runs/plan-2026-08-31-a1b2c3d4/plan.json

# Sabit eşzamanlılık çalıştırması
adaptea run "Arama filtreleme modülünü yaz" --scheduler fixed --concurrency 4

# Naif paralel çalıştırma
adaptea run "Loglama altyapısını yeniden yapılandır" --scheduler naive --max-agents 8

3. Durum inceleme ve devam etme (`status` & `resume`)

Çalıştırma durumu kalıcıdır. Bilgisayarınız kapanırsa veya süreç durdurulursa, yapılmış işleri kaybetmeden durumu görebilir ve devam edebilirsiniz:

Durum ve devam etme komutları

# En son çalıştırmanın durumunu göster
adaptea status

# Belirli bir çalıştırmanın durumunu göster
adaptea status <run-id>

# Birleştirilmiş işleri tekrarlamadan yarıda kalan çalıştırmayı sürdür
adaptea resume <run-id>

Model filosu CLI yönetimi

Birden çok yerel model veya model örneği kullanırken Model Filosu açık roller (planlayıcı, inceleyici, ajan) atar ve işleri yetenek katmanlarına (güçlü veya hızlı havuz) yönlendirir.

adaptea fleet listKeşif

İndirilmiş yerel modelleri, yüklü örnek kimliklerini, yuva sayılarını, atanmış rolleri ve yetenek katmanlarını listeler.

adaptea fleet statusHavuz durumu

Aktif ajan havuzlarını, hedef yuvaları görüntüler ve filo profilinin (.adaptea/fleet.json) güncel olup olmadığını denetler.

adaptea fleet configureRol ayarları

Planlayıcı, inceleyici, güçlü ajan ve hızlı ajan havuzları için etkileşimli ya da parametrik katman ataması yapar.

adaptea fleet calibrateTopoloji testi

Çok örnekli sürekli toplu işleme ile kopya örnekleri kıyaslar ve en iyi düzeni gerçek ajan testleriyle doğrular.

Model filosu yönetim komutları

# Modelleri ve yüklü örnekleri listele
adaptea fleet list

# Filo havuzlarını ve profil durumunu incele
adaptea fleet status

# Model katmanlarını ve rollerini yapılandır
adaptea fleet configure

# Aday filo düzenlerini ölç ve kaydet
adaptea fleet calibrate --repetitions 3

Kalibrasyon ve testler

Adaptea, kabul hedeflerini genel tahminlere değil, donanımınız üzerinde yapılan gerçek ölçümlere dayandırır.

Tek model eşzamanlılık kalibrasyonu (`adaptea calibrate`)

Belirlenen eşzamanlılık seviyelerini (örn. 1, 2, 4, 8) tarar; ilk tokene kadar geçen süreyi (TTFT), token üretim hızını ve bellek bant genişliği ölçeklenmesini ölçer. Çıktılar .adaptea/capacity.json, CSV ve HTML raporu olarak kaydedilir:

Kalibrasyon komutları

# Farklı eşzamanlılık düzeylerinde standart kalibrasyon
adaptea calibrate --concurrency 1,2,4,8 --repetitions 3

# Hızlı geliştirme kontrolü
adaptea calibrate --quick

Yeniden üretilebilir karşılaştırma testi (`adaptea benchmark`)

Seri, Sabit, Naif ve Uyarlanabilir modları tamamen aynı temiz Git commit'i ve değişmeyen plan üzerinde adil biçimde karşılaştırır:

Karşılaştırma testi ve raporlama

# Seri, Sabit, Naif ve Uyarlanabilir modların adil karşılaştırması
adaptea benchmark --plan fixtures/benchmark/plan.json --repetitions 3 --fixed-concurrency 2 --max-agents 8

# Birleştirilmiş JSON, CSV ve HTML raporu oluştur
adaptea report

Ajan komut güvenliği politikası

Kodlama ajanları projeye özel, etkileşimsiz bir komut güvenliği politikası altında çalışır. Komutlar üç belirgin kategoriye ayrılmıştır:

Kategori	Uygulanan Eylem	Örnekler ve Kurallar
Varsayılan güvenli	Otomatik izin verilir	Salt okunur işlemler ve test komutları (örn. `pytest`, `npm test`, `cargo test`, `git status`).
Onay gerekli	Onaylanmadıkça reddedilir	Paket kurulumları (`npm install`, `pip install`), ağ erişimi, Git değişiklikleri. `adaptea.toml` onayı gerektirir.
Engellendi	Daima reddedilir	Sistem geneli yetki yükseltme (`sudo`), disk biçimlendirme, yıkıcı silmeler (`rm -rf /`), force push. Geçersiz kılınamaz.

Projenizin geçerli komut güvenliği politikasını terminalden görüntülemek için:

Güvenlik politikasını görüntüle

adaptea command-policy

Belirli komut kalıplarını onaylamak için projenizin adaptea.toml dosyasına ekleyin:

adaptea.toml yapılandırması

[worker.command_security]
approved_commands = [
  "npm install zod@4",
  "pip install pytest-asyncio"
]

Uyarlanabilir zamanlama

Adaptea kaç kodlama ajanının başlayabileceğini kontrol eder. LM Studio ile canlı çıkarım yükünü izler ve hareketli pencere, histerezis ve bekleme süresi kullanarak kabul hedefini ayarlar. Hedefin düşmesi, sağlıklı biçimde çalışan işleri sonlandırmaz.

adaptea / denetleyici

fan_out(t) = min(admission_target(t), ready_tasks(t),
                 user_ceiling, backend_parallel_limit)

llama.cpp için Adaptea aktif işleme slotlarını (/slots) yerel olarak izler. vLLM için canlı KV-cache yükünü ve motor kuyruk telemetrisini (/metrics) ayrıştırır. Ollama içinse mevcut olmayan telemetriyi uydurmak yerine güvenli bir eşzamanlılık tavanı uygular.

Uyarlanabilir Model Filosu

Filo modu isteğe bağlıdır. Bir veya daha fazla yerel model örneğine planlayıcı, ajan ve inceleyici gibi açık roller atayabilirsiniz. Kullanıcı tanımlı katmanlar, düşük karmaşıklıktaki görevleri hızlı modellere yönlendirirken yüksek karmaşıklıktaki işleri güçlü modelde tutar.

Gösterişli ama yanıltıcı ölçümler yok

Adaptea daha fazla model örneğinin daha hızlı olduğunu varsaymaz. Aday düzenleri sizin donanımınızda ölçer ve gerekli bilgiler eksikse otomatik seçim yapmaz.

Çalışma ağaçları ve doğrulama

Her kodlama görevi yalıtılmış bir Git çalışma ağacında çalışır. Adaptea pytest veya gerçek bir npm test betiği gibi projenin doğrulayıcısını algılar ya da adaptea.toml içindeki açık komutu kullanır. Yalnızca geçen görev dalları birleştirilir.

Çalıştırma durumu .adaptea/ altında kalıcıdır. Uygulama veya makine durursa Devam Et, tükenmiş yeniden deneme haklarını gelişigüzel yenilemeden çalıştırmayı yeniden kurar.

İndirmenizi doğrulayın

Her sürüm, platforma özgü SHA-256 sağlama toplamları içerir. macOS sürümleri (Apple silicon ve Intel) Developer ID ile imzalanmış, Apple tarafından noter onaylıdır ve biletler doğrudan disk görüntüsüne eklenmiştir.

Sürüm numaralarını eşleştirin

Yükleyici dosya adı, sağlama toplamı dosyası ve İndirme sayfasındaki sürüm aynı olmalıdır. Sağlama toplamı eşleşmeyen bir dosyayı kurmayın.

macOS sağlama toplamı

shasum -a 256 -c Adaptea-macos-arm64.dmg.sha256

macOS'ta kurulumdan sonra ayrıca spctl --assess --type execute --verbose /Applications/Adaptea.app komutunu çalıştırarak noter onayını doğrulayabilirsiniz.

SONRAKİHerkese açık betayı indir→