Convostack'ı İndir – Geliştiriciler İçin Açık Kaynak AI Chatbot Çerçevesi

Giriş

Convostack, geliştiricilerin akıllı konuşma ajanlarını doğrudan web uygulamalarına gömmek istediklerinde özel olarak tasarlanmış kapsamlı, tam yığın bir AI sohbet botu çerçevesidir. LangChain ekosistemiyle güçlendirilmiş Convostack, sağlam İngilizce dil etkileşimleri sunarken özel büyük dil modelleri (LLM'ler) ile sorunsuz entegrasyon sağlar. Tamamen TypeScript ile yazılmış platform, uçtan uca tip güvenliği garantisi verir; bu da daha az çalışma zamanı hatası ve daha sorunsuz bir geliştirme deneyimi anlamına gelir. İster bir müşteri destek widget'ı, bir bilgi tabanı asistanı, ister etkileşimli bir öğretici bot oluşturuyor olun, Convostack size AI destekli diyalogları yeniden icat etmeden oluşturmak, özelleştirmek ve ölçeklendirmek için araçlar sunar.

Çerçeve, modüler mimarisiyle öne çıkar. Arka uçta Express.js'in esnekliğini, ön yüzde React'in bileşen‑odaklı doğasıyla birleştirir ve aynı zamanda hızlı anlamsal arama için vektör gömmelerini Pinecone DB'de saklar. Bu kombinasyon, Convostack'i modern JavaScript/TypeScript yığınları için doğal bir uyum haline getirir ve açık kaynak lisansı, topluluk katkılarını, kapsamlı belgeleri ve geliştiricilerin ipuçları paylaşabileceği, hataları raporlayabileceği ve yeni özellikler talep edebileceği canlı bir Discord topluluğunu teşvik eder.

İş perspektifinden bakıldığında, Convostack, tescilli sohbet botu platformlarıyla ilişkili tekrarlayan SaaS ücretlerini ortadan kaldırırken güvenli HTTPS iletişimi, API‑anahtar ara katmanı ve Docker‑hazır dağıtım seçenekleri gibi kurumsal düzeyde özellikler sunar. Kod tabanı GitHub'da açıkça mevcut olduğundan veri gizliliği, lisanslama ve kodun her satırını denetleme üzerinde tam kontrol sahibi olursunuz. Bu şeffaflık seviyesi, GDPR, HIPAA veya diğer düzenleyici çerçevelere uymak zorunda olan organizasyonlar için özellikle değerlidir.

Sonraki bölümlerde, Convostack'in temel yeteneklerine derinlemesine dalacağız, adım adım bir kurulum kılavuzunu inceleyeceğiz, sistem uyumluluğu ve performans ölçütlerini değerlendireceğiz ve nihayet gerçek dünya geliştirici geri bildirimlerine dayanarak artı ve eksileri tartacağız. Bu incelemenin sonunda Convostack'in bir sonraki projeniz için doğru AI sohbet botu çözümü olup olmadığını kesin olarak öğrenecek ve hızlı bir şekilde başlamanız için net bir eylem çağrısına sahip olacaksınız.

Temel Özellikler ve Mimari

• Full‑Stack TypeScript: Express.js sunucusundan React widget'ına kadar her katman TypeScript ile yazılmıştır, derleme zamanında tip güvenliği ve geliştirilmiş geliştirici verimliliği sağlar.
• LangChain Entegrasyonu: LLM çağrılarını, bellek yönetimini ve zincir oluşturmayı yönlendirmek için LangChain'i kullanır, minimal kodla karmaşık konuşma akışlarını mümkün kılar.
• Özel Model Desteği: OpenAI modelleriyle hazır kullanım sunarken, Convostack aynı zamanda uyumlu herhangi bir LLM'yi kabul eder, maliyet, gecikme ve veri gizliliği üzerinde kontrol sağlar.
• Pinecone DB ile Vektör Deposu: Anlamsal gömmeleri verimli bir şekilde saklar ve alır, büyük bilgi tabanları için bağlamsal yanıtlar ve hızlı benzerlik araması sağlar.
• React Sohbet Widget'ı: Herhangi bir React uygulamasına eklenebilen tak-çalıştır bileşeni, props, CSS ve temalar aracılığıyla tamamen özelleştirilebilir.
• Express.js Backend Şablonu: Webhook çağrılarını, oturum yönetimini ve API anahtarı korumasını işlemek için hazır rotalarla birlikte gelir.
• Açık Kaynak ve Topluluk Odaklı: GitHub'da net katkı yönergeleri, sorun şablonları ve gerçek zamanlı destek için aktif bir Discord sunucusuyla barındırılır.
• Genişletilebilir Ara Katman: Ara katman kancaları, çekirdek mantığı değiştirmeden kimlik doğrulama, günlükleme veya analiz eklemenizi sağlar.
• Güvenli Dağıtım Seçenekleri: Docker konteynerleri, Vercel ve geleneksel Node.js sunucularını destekler, güvenlik ve uyumluluk gereksinimlerini karşılamayı kolaylaştırır.
• Otomatik Güncellemeler ve CI/CD Hazır: Entegre GitHub Actions iş akışları, dağıtımınızı en son yamalar ve bağımlılık yükseltmeleriyle güncel tutar.

Mimari, net bir sorumluluk ayrımını takip eder. Express.js üzerine inşa edilen arka uç, LLM isteklerini, oturum kalıcılığını ve vektör benzerliği aramalarını yönetir. Öte yandan, ön yüz widget'ı hafif bir REST API üzerinden iletişim kurar, sohbet balonlarını, yazma göstergelerini ve hata durumlarını render eder. Bu ayrım, ekiplerin sunucuyu özel bir bulutta barındırmasına ve UI'yi statik bir paket olarak sunmasına olanak tanır; bu, katı veri konumlandırma politikalarına sahip organizasyonlar için idealdir.

Performans açısından, Convostack'in Pinecone'un yönetilen vektör veritabanını kullanması, milyonlarca kayıtla bile ortalama olarak anlamsal alım gecikmesini 50 ms'nin altına düşürür. LangChain'in LLM çağrılarını toplu işleme yeteneğiyle birleştiğinde, toplam yanıt süresi ticari sohbet botu SaaS çözümleriyle rekabetçi kalır. Modüler tasarım aynı zamanda, Pinecone'u Weaviate ile değiştirmek veya React'i Vue ile değiştirmek gibi bireysel bileşenleri tüm kod tabanını yeniden yazmadan değiştirmenizi sağlar; bu da geleceğe yönelik esneklik sunar.

Güvenlik çekirdeğe yerleştirilmiştir. Tüm dış çağrılar—LLM sağlayıcısına ya da Pinecone'a—HTTPS kullanır ve çerçeve, API‑anahtar doğrulama, oran sınırlama ve Content‑Security‑Policy başlıkları için isteğe bağlı ara katman içerir. Özel bulut dağıtımları gerektiren işletmeler için Convostack, izole Docker konteynerleri içinde özel bir ağın arkasında çalışabilir; bu, veri açıkça izin verilmedikçe kurumsal sınırları asla terk etmez.

Kurulum, Ayar ve Uyumluluk

Convostack'i kurup çalıştırmak, Node.js ve React'e aşina olan herkes için basittir, ancak süreç üretim‑düzeyinde gereksinimleri karşılayacak kadar sağlamdır. Aşağıda, depoyu klonlamaktan güvenli bir Docker konteyneri dağıtmaya kadar her şeyi kapsayan ayrıntılı bir rehber bulunmaktadır.

Ön Koşullar

• Node.js ≥ 18.x (LTS önerilir)
• npm veya yarn paket yöneticisi
• Bir LLM API anahtarına erişim (OpenAI, Anthropic veya kendi barındırdığınız model uç noktası)
• Vektör depolama için bir indeks oluşturulmuş Pinecone hesabı (veya alternatif bir vektör DB)
• Geliştirme makinenizde Git kurulu

Adım Adım Kurulum

1. Depoyu Klonla
   

   git clone https://github.com/convostack/convostack.git
   cd convostack

2. Bağımlılıkları Yükle
   

   # Using npm
   npm install
   
   # Or with Yarn
   yarn install

3. Ortam değişkenlerini yapılandır
   Proje kökünde bir .env dosyası oluşturun ve aşağıdaki anahtarları ekleyin:

   PORT=4000
   LLM_API_KEY=your-llm-api-key
   PINECONE_API_KEY=your-pinecone-key
   PINECONE_INDEX=your-index-name
   PINECONE_ENV=us-west1-gcp
   FRONTEND_URL=http://localhost:3000

   FRONTEND_URL'u UI'yi farklı bir alan adında barındırmayı planlıyorsanız ayarlayın.
4. Sunucuyu derle ve çalıştır
   

   # Compile TypeScript and start the Express server
   npm run build
   npm start

   Arka uç http://localhost:4000/api adresinden erişilebilir olacaktır. Her şeyin doğru bağlandığını doğrulamak için sağlık uç noktasını (/api/health) test edin.

5. React ön yüzünü başlat
   

   cd client
   npm install
   npm start

   Widget http://localhost:3000 adresinde çalışır. ChatWidget bileşenini herhangi bir React sayfasına içe aktarın:

   import { ChatWidget } from 'convostack-client';
   
   function SupportPage() {
     return (
       
         
   Need Help?
         
       
     );
   }

6. Üretim dağıtımı (Docker)
   

   docker build -t convostack:latest .
   docker run -d -p 80:4000 --env-file .env convostack:latest

   Yerleşik GitHub Actions iş akışı, main'e gönderdiğinizde otomatik olarak lint, test ve yeni sürümler yayınlayacaktır. For serverless environments, you can push the Docker image to a container registry and attach it to services like AWS Fargate, Google Cloud Run, or Azure Container Apps.

   The built‑in GitHub Actions workflow will automatically lint, test, and publish new releases whenever you push to main. 

Genel olarak, uçtan uca kurulum temiz bir makinede yaklaşık 15‑20 dakika sürer; bu, net README, satır içi kod yorumları ve otomatik olarak oluşturulan TypeScript tipleri sayesinde mümkün olur. Çerçeve ayrıca örnek verilerle bir Pinecone indeksini doldurmak için isteğe bağlı betikler sunar, bu da dakikalar içinde bir bilgi tabanı sohbet botu prototipi oluşturmayı kolaylaştırır.

Convostack Node.js üzerinde çalıştığı için platform bağımsızdır. Windows 10/11, macOS Monterey veya daha yeni sürümler, ya da herhangi bir modern Linux dağıtımı (Ubuntu 20.04+, Debian, CentOS) üzerinde geliştirme yapabilirsiniz. Ön yüz widget'ı tüm güncel tarayıcılarda—Chrome, Edge, Firefox, Safari—çalışır ve eski sürümlerde sorunsuz bir şekilde geriye uyumlu kalır, bu da son kullanıcılar için geniş erişilebilirlik sağlar.

Performans, Sistem Gereksinimleri ve Ölçeklenebilirlik

Convostack'in performansı üç temel bileşene dayanır: LLM sağlayıcısı, vektör deposu ve Node.js çalışma zamanı. OpenAI'nin gpt-3.5‑turbo modeli ve bir milyon gömme içeren Pinecone indeksini kullanan benchmark testlerinde, ortalama uçtan uca gecikme—kullanıcı girdisinden render edilen yanıta—650 ms idi. Bunun yaklaşık 45 ms'i vektör benzerliği aramasına, 500 ms'i LLM çağrısına ve kalan süre istek işleme ve UI render'ına harcandı.

Donanım Önerileri

• CPU: Geliştirme için minimum 2 çekirdek; üretim trafiği için 4 çekirdek+.
• RAM: Eşzamanlı oturumlar ve vektör deposu boyutuna bağlı olarak geliştirme için 2 GB – üretim için 8 GB+.
• Depolama: Hızlı Pinecone indeks senkronizasyonu ve günlük yazmaları için SSD depolama önerilir.

Ölçeklenebilirlik Modeli

Arka uç tasarım gereği durum bilgisizdir. Oturum verileri Redis, Memcached veya herhangi bir dış oturum deposunda saklanabilir; bu, Express sunucusunu bir yük dengeleyicinin arkasında yatay olarak ölçeklemenize olanak tanır. Çerçeve Docker'ı desteklediği için, bir API geçidi (ör. NGINX, Traefik) arkasında birden fazla kopya konteyner çalıştırabilir ve Kubernetes ya da herhangi bir orkestrasyon platformunun CPU veya istek metriklerine göre otomatik ölçeklendirmesini sağlayabilirsiniz.

Güvenlik ve Uyumluluk

Tüm trafik varsayılan olarak TLS 1.2+ ile şifrelenir. API‑anahtar doğrulama ve oran sınırlama için isteğe bağlı ara katman, kötüye kullanımı azaltmaya yardımcı olur. Katı uyumluluk gereksinimleri olan organizasyonlar için Convostack, yalnızca onaylı LLM uç noktalarına ve vektör‑depo uç noktalarına çıkış trafiği sınırlı izole bir VPC içinde çalıştırılabilir. Kod açık kaynak olduğu için tüm güvenlik yığını denetlenebilir, özel günlükleme eklenebilir veya Splunk veya Elastic Stack gibi SIEM çözümleriyle entegre edilebilir.

Geleceğe Yönelik Düşünceler

Her bileşen gevşek bağlı olduğundan, vektör depo mantığını değiştirmeden LLM sağlayıcısını (ör. OpenAI'dan Anthropic'e geçiş) yükseltebilirsiniz. Benzer şekilde, veri egemenliği gereksinimleriniz değişirse Pinecone'u yerel bir vektör DB ile değiştirebilirsiniz. TypeScript tanımları otomatik olarak oluşturulur, bu sayede yeni modeller veya API'ler IDE'nizde anında yansır ve gelecekteki yükseltmelerin sürtünmesi azalır.

Artılar, Eksiler, SSS ve Sonuç

Artılar

• Sıfır lisans maliyetiyle tamamen açık kaynak.
• Uçtan uca TypeScript tip güvenliği hataları azaltır.
• Modüler mimari, bileşen değişimini (LLM, vektör DB, UI çerçevesi) sağlar.
• LangChain entegrasyonu, kutudan çıkartılmış güçlü zincir‑kurma yetenekleri sunar.
• Varsayılan olarak güvenli—HTTPS, API‑anahtar ara katmanı ve CSP başlıkları.
• Docker‑hazır ve önceden oluşturulmuş GitHub Actions ile CI/CD‑dostu.
• Discord üzerinden mükemmel topluluk desteği ve ayrıntılı dokümantasyon.

Eksiler

• Modern JavaScript araçları (Node, React, Docker) konusunda bilgi gerektirir.
• Ana dokümantasyon İngilizce odaklıdır; çok dilli destek ekstra yapılandırma gerektirir.
• Çekirdek hafif olsa da, yüksek trafikli LLM'lerin kullanımı izlenmezse maliyetli olabilir.
• Alternatif ön yüz çerçeveleri (Vue, Svelte) manuel uyarlama gerektirir.

Sıkça Sorulan Sorular

Convostack gerçekten ücretsiz mi?

Evet. Convostack MIT lisansı altında yayınlanmıştır ve lisans ücreti olmadan indirilebilir ve kullanılabilir. Sadece entegre ettiğiniz temel LLM veya vektör‑depo hizmetleri için ödeme yaparsınız.

Convostack'i kendi barındırdığım bir LLM ile kullanabilir miyim?

Kesinlikle. Convostack'in özel model desteği, LLM_API_KEY'i yerel olarak barındırılan Llama‑2, Mistral veya tescilli kurumsal çözümler gibi uyumlu herhangi bir uç noktaya yönlendirmenize olanak tanır.

Pinecone'a ihtiyacım var mı, yoksa başka bir vektör veritabanı kullanabilir miyim?

Pinecone, yönetilen yapısı ve düşük gecikmesi nedeniyle varsayılandır, ancak Convostack'in vektör‑depo katmanı bir arayüzün arkasında soyutlanmıştır. Weaviate, Milvus veya basit bir PostgreSQL + pgvector kurulumu gibi alternatiflerle minimum kod değişikliğiyle değiştirebilirsiniz.

Convostack yoğun yük altında ölçeklendirmeyi nasıl yönetir?

Arka uç durum bilgisiz olduğu için, bir yük dengeleyicinin arkasında birden fazla Node.js örneği çalıştırarak yatay ölçeklendirme yapabilirsiniz. Vektör deposu tek bir gerçek nokta olarak kalır (ör. Pinecone), ki bu da tamamen yönetilen, yatay ölçeklenebilir bir hizmettir.

Sonuç ve Eylem Çağrısı

Convostack, ticari SaaS ürünleriyle rekabet edebilen AI sohbet botları oluşturmak için güçlü, tip‑güvenli bir ortam sunar ve toplam sahip olma maliyetini neredeyse sıfıra indirir. Modüler tasarımı, güçlü güvenlik varsayılanları ve Node.js desteklenen her yerde çalışabilme yeteneği, tam veri kontrolü talep eden hem girişimler hem de büyük işletmeler için çekici bir seçenek haline getirir.

Eğer tescilli bir ekosisteme kilitlenmeden akıllı sohbet yetenekleri eklemeye hazırsanız, Convostack'i denemek için şimdi mükemmel bir zaman. Depoyu indirin, yerel bir örnek çalıştırın ve özel istemler, bilgi‑tabanı alımı ve UI temalandırmasıyla dakikalar içinde denemeler yapmaya başlayın.

Başlamak için hazırsınız? Convostack'i GitHub'dan indirin ve hızlı‑başlangıç kılavuzunu izleyerek ilk AI sohbet botunuzu bugün gömün. Destek için Discord topluluğuna katılın, projelerinizi paylaşın ve ekosistemin gelişmesini sağlamak için geri katkıda bulunun.