n8n'in Self-hosted AI Starter Kit'i, bulut API'leri olmadan yerel YZ iş akışları için Docker Compose üzerinden n8n, Ollama, Qdrant ve PostgreSQL'i başlatır.
Verilerini bulut sağlayıcılarına göndermeden yerel yapay zeka (YZ) iş akışları oluşturmak isteyenler, n8n'in Self-hosted AI Starter Kit'inde hazır bir Docker Compose şablonu bulur. Bu şablon tek bir komutla iş akışı orkestrasyonu için n8n'i, yerel dil modelleri için Ollama'yı, vektör veritabanı olarak Qdrant'ı ve veri deposu olarak PostgreSQL'i başlatır. resmi n8n dokümantasyonunda kit, YZ iş akışlarının hızla oluşturulmasını sağlayan derlenmiş bir YZ bileşenleri koleksiyonu olarak tanımlanıyor, eksiksiz kurulum ise n8n-io/self-hosted-ai-starter-kit GitHub deposunda yer alıyor. Orada kitin açıkça bir başlangıç noktası olarak düşünüldüğü, üretime hazır bir çözüm olmadığı belirtiliyor. Durum: Temmuz 2026.
Yığın, her biri net bir şekilde tanımlanmış bir görevi üstlenen dört konteyneri birleştirir. Deponun README dosyasına göre bunlar tek tek şöyledir:
Yığın, Docker Compose profilleri aracılığıyla mevcut donanıma uyarlanabilir. Nvidia ekran kartları için docker compose --profile gpu-nvidia up komutu yığını GPU hızlandırmasıyla başlatır, Linux'ta bu, gpu-amd profili üzerinden AMD kartlar için de benzer şekilde çalışır. Özel bir GPU olmadan yığın CPU profilinde de çalışır, bu durumda model hesaplamasını işlemci üstlenir, bu da daha büyük modellerde belirgin şekilde daha uzun sürer. Mac'te GPU doğrudan Docker'a aktarılamaz, burada dokümantasyon Ollama'yı yerel olarak ana sistemde çalıştırmayı ve n8n'i normal şekilde docker compose up ile başlatmayı önerir.
Başlangıç, alışılmış Docker Compose düzenini izler: depoyu GitHub'dan klonlamak, .env.example dosyasını .env olarak kopyalamak ve içindeki gizli bilgileri ve parolaları düzenlemek, ardından uygun profil komutunu çalıştırmak. Başlatıldıktan sonra n8n http://localhost:5678/ adresinden erişilebilir olur, burada bir kez kullanıcı hesabı oluşturulur. Kit, sohbet düğmesi üzerinden doğrudan test edilebilen hazır bir örnek iş akışıyla birlikte gelir. İş akışları ile yerel dosya sistemi arasındaki veri alışverişi için ayrıca /data/shared altında ortak bir klasör konteynerlere bağlanmıştır. Yığını güncel tutanlar, ilgili profille yeniden başlatmadan önce güncellemeler için karşılık gelen pull ve create komutlarını kullanır.
Depo, örnek iş akışları olarak randevu planlaması için YZ ajanlarını, PDF belgelerinin özetlenmesini, Slack botlarının genişletilmesini ve finansal belgelerin analizini, ayrıca vergi konuları için şablonları ve Qdrant ile bir Mistral modeli kullanılarak yapılan belge değerlendirmesini sayıyor. Ortak payda: faturalar, sözleşmeler veya müşteri verileri gibi hassas belgeler kendi altyapısını terk etmiyor. Bu, bulut API'lerine kıyasla temel avantajdır. Dürüst olmak gerekirse, standart donanımda çalışan yerel modeller, yanıt hızı ve akıl yürütme kalitesi açısından şu anda büyük bulut modellerinin belirgin şekilde gerisinde kalıyor, özellikle karmaşık çok adımlı görevlerde. Sınıflandırma, özetleme veya basit çıkarım gibi net şekilde tanımlanmış görevler için performans genellikle yeterlidir, özellikle veri koruma ve altyapı üzerindeki kontrol, maksimum model kalitesinden daha önemliyse. Böyle bir mimariyi üretimde ve güvenli şekilde kullanmak isteyen şirketler için genellikle hangi kullanım durumlarının YZ ajanları için kendi altyapılarında uygun olduğunu ve hibrit bir çözümün ne zaman daha mantıklı olduğunu değerlendirmek değerlidir. NordFlux, bu tür yığınların seçiminde ve kurulumunda şu kapsamda destek sağlar: otomasyon projeleri.
Resmi n8n dokümantasyonuna göre, ek çalışma yapılmadan kesinlikle değil: kit "üretim ortamları için tam olarak optimize edilmemiştir" ve üretimde kullanılmadan önce uyarlanmalı, güvenli hale getirilmeli ve sağlamlaştırılmalıdır.
Hayır. Yığının GPU olmadan da çalışmasını sağlayan ayrı bir CPU profili vardır, ancak bu durumda model hesaplaması daha uzun sürer. Nvidia ve AMD ekran kartları Ollama'yı ilgili GPU profilleri üzerinden hızlandırır, Mac'te ise Ollama bunun yerine doğrudan ana sistemde çalıştırılır.
Depo, Apache License 2.0 lisansı altındadır, eksiksiz koşullar GitHub deposunun LICENSE dosyasında bulunur.
Evet. Docker Compose kurulumu, üzerine kendi iş akışlarınızın, ek entegrasyonların ve uyarlanmış modellerin inşa edilebileceği temel bir çerçeve görevi görür, dahil edilen örnek iş akışı ise yalnızca temel yapıyı gösterir.
NordFlux'un kurucusu. Webden ve SEO'dan grup ölçeğindeki otomasyona kadar yedi yıllık deneyim, bugün KOBİ'ler için pragmatik biçimde ve Alman veri egemenliğiyle.
Sertifikalar
n8n'i Ollama kimlik bilgisi üzerinden yerel yapay zeka modellerine nasıl bağlayacağınız, Docker tuzağı ve tool-calling sınırları dahil.
n8n, Docker Compose ile nasıl kurulur: SQLite yerine Postgres, .env, volume'ler ve güncellemeler adım adım.
n8n Cloud paralel çalıştırmaları sınırlar: Starter 5, Pro 20, Enterprise 200+. Bunun toplu işlemeye etkisi ve batching'in nasıl yardımcı olduğu.
Starter kit hızla kurulur, ancak üretim demek kaynak yönetimi, dört servis için güncellemeler ve Qdrant ile PostgreSQL için yedekler demektir. NordFlux, n8n, Ollama ve Qdrant'tan oluşan yerel yapay zeka stack'lerini yük altında ve güncellemelerden sonra da güvenilir çalışacak şekilde işletir. Stack'inizin üretime hazır olması için nelerin eksik olduğunu birlikte değerlendiririz.
