Ragmux, kendi altyapınızda çalıştırdığınız bir AI geçididir. Uygulamalarınız tek bir OpenAI uyumlu API ile konuşur; Ragmux isteği arkadaki sağlayıcıya iletir ve istenirse yüklediğiniz belgelerden getirdiği bağlamı ekler. Tunedness tarafından geliştirilir.
Tek API, birçok sağlayıcı
/v1/chat/completions (JSON ve SSE), /v1/models, /v1/embeddings, /v1/retrieve ve /v1/rerank uç noktaları OpenAI uyumludur. Anthropic ve Gemini çevirisi araç çağrılarını da kapsar. Anthropic SDK’ları ve Claude Code, yalnızca temel URL değiştirilerek /v1/messages üzerinden bağlanabilir. Tek bir reasoning_effort ayarı, sağlayıcıların kendi düşünme kontrollerine eşlenir.
Belgelerden getirme
PDF, DOCX, HTML, TXT ve Markdown dosyaları yüklenir; bölüm farkındalıklı parçalama, pgvector ile PostgreSQL tam metin ya da ParadeDB BM25 birleşiminden oluşan hibrit arama, yeniden sıralama ve metadata filtreleme sunulur. RAG deposu, /mcp adresindeki MCP sunucusu üzerinden ajanlara arama aracı olarak da açılabilir.
Yönlendirme ve denetim
Hedefler öncelikli ya da ağırlıklı seçilir; ilk bayttan önce yeniden deneme ve bağlantı başına devre kesici vardır. Proje başına sk-proj- anahtarı, admin, editor, viewer rolleri, giriş kilidi ve denetim kaydı bulunur. Proje bazında hız sınırı ve token bütçesi uygulanır; düzenlenebilir bir fiyat tablosuyla maliyet tahmini yapılır. Gözlemlenebilirlik için istek kaydı, kimlik doğrulamalı Prometheus /metrics ve OpenTelemetry izleri sunulur.
Kurulum ve sınırlar
Ragmux Go ile yazılmış statik bir ikili dosyadır; PostgreSQL ve pgvector ile birlikte tek konteynerde gelir. Ayrı bir vektör veritabanı ya da Redis gerekmez. Henüz olmayanlar: taranmış PDF’ler için OCR, SSO/OIDC girişi ve para cinsinden bütçe.
Lisans
AGPL-3.0-or-later. Ticari lisans da mevcuttur. Kaynak kodu GitHub üzerinde geliştirilir.
Öne çıkan özellikler
- Tek OpenAI uyumlu API arkasında OpenAI, Azure OpenAI, Anthropic, Gemini, DeepSeek, Ollama ve özel OpenAI uyumlu uç noktalar
- Yüklenen belgelerden (PDF, DOCX, HTML, TXT, Markdown) hibrit arama ve yeniden sıralama
- Anthropic uyumlu /v1/messages ve RAG deposunu araç olarak sunan MCP sunucusu
- Proje başına anahtar, rol tabanlı erişim, hız sınırı ve token bütçesi
- Öncelikli ve ağırlıklı yönlendirme, yeniden deneme, bağlantı başına devre kesici
- Tek Docker konteyneri: ayrı vektör veritabanı ve Redis gerekmez
Sıkça sorulan sorular
Ragmux tam olarak ne yapıyor?+
Birden çok LLM sağlayıcısını tek bir OpenAI uyumlu API'de toplayan ve yüklenen belgelerden getirme (retrieval) ekleyen, kendi sunucunuzda çalışan bir AI geçididir.
Hangi sağlayıcılarla çalışıyor?+
OpenAI, Azure OpenAI, Anthropic, Gemini, DeepSeek ve Ollama doğrudan desteklenir. vLLM, LM Studio ya da LiteLLM gibi OpenAI uyumlu uç noktalar özel sağlayıcı olarak eklenebilir. Yeniden sıralama için Cohere ve Voyage kullanılabilir.
Nasıl kuruluyor?+
Docker ile. Hepsi bir arada konteyner imajı, yalnızca geçidi içeren imaj ve BM25 aramalı ParadeDB imajı bulunur; ayrıca bir docker-compose dosyası vardır. İmajlar imzalıdır.
Verilerim dışarı gidiyor mu?+
Proje 'nothing phones home' diyor: telemetri göndermez. Sağlayıcı anahtarları AES-256-GCM ile şifrelenerek saklanır. İstekler yalnızca sizin yapılandırdığınız sağlayıcılara gider.
Taranmış PDF'lerde çalışır mı?+
Hayır. OCR henüz yok. SSO/OIDC ile giriş ve para cinsinden bütçe de henüz yayınlanmış değil.
Lisansı ve fiyatı nedir?+
Ragmux, AGPL-3.0-or-later ile lisanslanmış özgür yazılımdır. Ticari lisans da mevcuttur; fiyatı herkese açık kaynaklarda belirtilmemiştir.
Bir sonraki projenizi birlikte kuralım
Fikrinizi anlatın, size en uygun çözümü tasarlayalım.
İletişime geç