AI Starter Kit: Docker Stack Olarak Ollama + Qdrant + n8n

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ın dört yapı taşı

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:

• n8n: 400'den fazla entegrasyona ve YZ ajanları için kendi bileşenlerine sahip düşük kodlu (low-code) platform, iş akışlarını orkestre eder ve diğer hizmetleri birbirine bağlar.
• Ollama: isteklerin kendi ağını terk etmesine gerek kalmadan güncel yerel dil modellerini kurmak ve çalıştırmak için platformlar arası bir ortam.
• Qdrant: embedding'leri depolayan ve anlamsal arama ile Retrieval-Augmented-Generation iş akışları için kullanılan, performanslı bir API'ye sahip açık kaynaklı vektör veritabanı.
• PostgreSQL: başta n8n'in kendisi ve iş akışı geçmişi olmak üzere kalıcı veri tutulmasını üstlenir.

GPU profilleri: Nvidia, AMD veya yalnızca CPU

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.

Birkaç adımda kurulum

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.

Yığın ne için uygundur ve yerel modeller nerede sınırlarına ulaşı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.

n8n AI Starter Kit, Ollama ve Qdrant hakkında sık sorulan sorular

Self-hosted AI Starter Kit üretim ortamı için uygun mu?

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.

Yığını çalıştırmak için mutlaka bir ekran kartına ihtiyacım var mı?

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.

Self-hosted AI Starter Kit hangi lisansa sahip?

Depo, Apache License 2.0 lisansı altındadır, eksiksiz koşullar GitHub deposunun LICENSE dosyasında bulunur.

Kendi n8n iş akışlarımı yığına entegre edebilir miyim?

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.