For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/web/agent-setup.md (or send Accept: text/markdown).
Kurulumu bir ajana yaptırın
Hazır bir istemi kodlama ajanına yapıştırın, bilgisayarınızda Web kurulumunu çalıştırmasına izin verin ve her adım hakkında yazdığı raporu kontrol edin.
Sıkıcı kısmı devredebilirsiniz
Bu depo, bir kodlama ajanının okuyabilmesi için yazıldı. Bir harita dosyası (llms.txt), bir kurallar dosyası (AGENTS.md), adım adım bir runbook (docs/agent-setup.md) ve hazır bir istem (prompts/agent-setup.md) ile gelir. Her kurulum komutunu kendiniz öğrenmek yerine tek bir istem yapıştırırsınız ve ajan runbook'u bilgisayarınızda izler.
Yazmayı devretmek, kontrolleri atlamak anlamına gelmez. Ajan, deponun sizdeki kopyası içinde çalışır ve ne yaptığını kanıtıyla bildirmek zorundadır. Aşağıdaki bölümler iyi bir raporun nasıl göründüğünü gösterir, böylece sonucun kontrolü sizde kalır.
Dürüst bir sınır: bu otomatik yol, Web uygulamasını ve arka ucunu — hesapları ve verileri yöneten sunucuyu — kurar. İstem ve runbook, Web deposu ve Tüm Platformlar monorepo'su ile birlikte gelir. Yalnızca Mobile ve yalnızca Desktop alımları bunun yerine kendi platforma özel llms.txt dosyalarını ve platform kurulum kılavuzlarını taşır.
Önce gerekenler
Önce hazırlık kılavuzunu tamamlayın: Node.js, Git ve bir düzenleyici kurulu olmalı, GitHub daveti kabul edilmeli ve supastack klasörü bilgisayarınıza indirilmiş olmalıdır. Ajan o klasörün içinde çalışır, bu nedenle Başlamadan önce kılavuzundaki her şey hâlâ geçerlidir.
Ayrıca kodlama ajanı olarak işlev görebilen bir araca ihtiyacınız var — yerleşik bir yapay zeka kodlama ajanına sahip bir düzenleyici (bir yapay zeka IDE'si) veya terminalinizde çalışan bir ajan (bir ajan CLI'si). Güncel herhangi bir ajan yetenekli araç iş görür; istem, neyi okuyup neyi çalıştırması gerektiğini zaten açıkça belirtir, bu nedenle talimatları kendiniz yazmanız gerekmez.
Son olarak, uygulamayı çalıştırmak için iki yoldan birine ihtiyacınız var: bilgisayarınızda kurulu Node.js 22 veya daha yenisi — hazırlık kılavuzunun kurduğu yol — ya da uygulamayı kapsayıcılar içinde çalıştıran ve kurulu Node.js gerektirmeyen Docker veya Podman gibi bir kapsayıcı aracı. İstemin içinde birini seçersiniz ve ajan onu izler.
İstemi kopyalayın, iki boşluğu doldurun, yapıştırın
Düzenleyicide prompts/agent-setup.md'yi açın — supastack klasörünün en üst seviyesindeki prompts klasöründe, llms.txt'nin yanında durur. Tüm metnini seçin ve kopyalayın.
İki yer tutucu sizin seçimlerinizi ister. <SETUP_PATH: docker | podman | host> yerine docker, podman veya host'tan birini yazın — host, uygulamayı kurduğunuz Node.js ile doğrudan bilgisayarınızda çalıştırır; docker veya podman ise kapsayıcılar içinde çalıştırır. <DEPLOY_TARGET: coolify | vps-docker | local-only> yerine uygulamanın nerede son bulacağını yazın — local-only, uygulamayı bu bilgisayarda çalıştırır ve hiçbir şey dağıtmaz; ilk bakış için doğru seçim budur.
Düzenlenmiş metni ajanın sohbetine yapıştırın ve gönderin. Aşağıdaki doldurulmuş ilk satır, docker artı local-only seçimlerini gösterir; o satırın altındaki numaralı adımlar dosyanın geldiği haliyle aynen kalır.
Stand up this supastack checkout end to end for **docker**
and deploy it to **local-only**.Ajan istemle ne yapar
İstem, ajanı runbook'a ve güvenlik kurallarına yönlendirir, ardından bunları sırayla işlemesini ve her aşamayı kanıtlamasını söyler. Sade bir dille ajan şunları yapar:
- Hiçbir şeye dokunmadan önce depo haritasını (
llms.txt), proje kurallarını (AGENTS.md) ve kimlik bilgisi işleme kurallarını (docs/agent-security.md) okur. node scripts/setup-env.mjsile.envyapılandırma dosyalarını oluşturur. Yardımcı yalnızca.env.example'dan kopyalar, bu nedenle ajan asla ayar adı uydurmaz ve zaten sahip olduğunuz sırların üzerine yazmak yerine onları korur.- Postgres'i — uygulamanın hesapları ve kayıtları tuttuğu veritabanını — ve uygulamanın kendisini başlatır; docker veya podman yolunda kapsayıcılar olarak, host yolunda bilgisayarınızdaki komutlarla.
- İlk gerçek oturum açmadan önce veritabanı geçişlerini — uygulamanın tablolarını oluşturan komutları — çalıştırır; çünkü tablolar oluşmadan önce oluşturulan bir hesap bozuktur.
- Her aşamayı bir denetim noktasında doğrular ve her kontrolü PASS, FAIL, BLOCKED veya NOT RUN olarak işaretleyen, onu destekleyen çıktıyla birlikte bir raporla bitirir.
Ajanın raporunda neyi kontrol edersiniz
İyi bir rapor iddia değil, kanıt gösterir. Her PASS'in arkasındaki gerçek health yanıtını ve komut çıktısını arayın — "her şey çalışıyor" gibi bir cümle değil.
İstem, ajana aynı adım iki kez başarısız olduktan sonra durup raporlamasını — başarısızlığın etrafından dolaşmamasını — ve bir veritabanını silmek gibi yıkıcı herhangi bir şeyden önce size sormasını söyler. Ajanınız tekrarlanan başarısızlıklardan sonra doğaçlamaya devam ederse, onu durdurun ve ilk hatayı sorun giderme kılavuzuna götürün.
İki şey asla görünmemelidir: bir hatayı susturmak için kapatılmış bir güvenlik özelliği ve sohbete ya da rapora yazdırılmış parola veya anahtar gibi gizli bir değer. Bunlardan birini görürseniz, çalıştırmayı başarısız sayın.
Demoyu ve gerçek bir oturum açmayı zihninizde ayrı tutun. /dashboard demosunun yerel referans akışı veritabanı gerektirmez, bu nedenle kendi başına geçebilir; /auth'ta hesap oluşturmak yalnızca geçişler çalıştıktan sonra işler. "Demo çalıştı" henüz "hesaplar çalışıyor" demek değildir.
Elle yapmayı tercih ederseniz
Yukarıdaki her adım aynı zamanda tıklama tıklama bir öğretici olarak da var. İlk demo için beş dakikalık Web kılavuzunu, ardından gerçek veritabanlı tam yerel ortam için Web yerel kurulumunu çalıştırın.
Kurulumu yapmamış olsa bile bir ajan kurulumdan sonra da yararlıdır — ajan iş akışı kılavuzu yeni ekranlar, yeniden stillendirme ve incelemeler gibi günlük görevleri kapsar.