README_tr.md

Cloud | Dokümantasyon | Yol Haritası | Discord

📕 İçindekiler

• 💡 RAGFlow Nedir?
• 🎮 Başlarken
• 🔥 Son Güncellemeler
• 🌟 Temel Özellikler
• 🔎 Sistem Mimarisi
• 🏠 Yerel Dağıtım
• 📚 Dokümantasyon
• 📜 Yol Haritası
• 🏄 Topluluk
• 🙌 Katkıda Bulunma

💡 RAGFlow Nedir?

RAGFlow, derin doküman anlayışına dayalı, açık kaynaklı ve öncü bir Artırılmış Üretim ile Bilgi Erişimi (RAG) motorudur. En son RAG teknolojisini Ajan yetenekleriyle birleştirerek LLM'ler için üstün bir bağlam katmanı oluşturur. Her ölçekteki kuruluşa uyarlanabilir, kolaylaştırılmış bir RAG iş akışı sunar. Yakınsanmış bir bağlam motoru ve hazır ajan şablonlarıyla donatılmış RAGFlow, geliştiricilerin karmaşık verileri yüksek doğrulukta, üretime hazır yapay zeka sistemlerine olağanüstü verimlilik ve hassasiyetle dönüştürmesini sağlar.

🎮 Başlarken

Bulut hizmetimizi https://cloud.ragflow.io adresinden deneyin.

Yerel dağıtım için Kendi Sunucusunda Barındırma bölümüne bakın.

🔥 Son Güncellemeler

• 2026-09-29 RAGFlow 1.0.0-rc1 yayımlandı.

• 2026-09-10 Site haritaları üzerinden web içeriği alımı eklendi.

• 2026-08-19 Belge ve veri kümesi düzeyinde Wiki, Graph, Tree, PageIndex, Mind Map, Timeline ve Skills üretmek için Knowledge Compilation tanıtıldı.

• 2026-08-19 Low, Medium, High ve Ultra düşünme modlarına sahip Agentic RAG tanıtıldı.

• 2026-07-02 Google BigQuery veri kaynağı alımı ve artımlı eşitleme eklendi.

Diğer güncellemeler için tam sürüm notlarına bakın.

🎉 Bizi Takip Edin

⭐️ Heyecan verici yeni özellikler ve iyileştirmelerden haberdar olmak için depomuzı yıldızlayın! Yeni sürümler için anında bildirim alın! 🌟

🌟 Temel Özellikler

🍭 "Kaliteli girdi, kaliteli çıktı"

• Karmaşık formatlara sahip yapılandırılmamış verilerden derin doküman anlayışı tabanlı bilgi çıkarımı.
• Kelimenin tam anlamıyla sınırsız token içinde "samanlıkta iğne bulma" yeteneği.

🍱 Şablon tabanlı parçalama

• Akıllı ve açıklanabilir.
• Aralarından seçim yapabileceğiniz çok sayıda şablon seçeneği.

🧩 Bilgi Derleme (Knowledge Compilation)

• Belge ve veri kümesi içeriğini Wiki, Graph, Tree, PageIndex, Mind Map, Timeline ve Skills gibi yapılandırılmış bilgi çıktılarına dönüştürün.
• Derleme modellerini ve işleme kurallarını yapılandırın; bilgi çıktılarını görüntüleyin, güncelleyin veya yeniden oluşturun.

🧠 Agentic Retrieval

• Karmaşık soruları analiz edin; gerektiğinde soruları alt parçalara ayırın, bilgi arayın ve kanıtları birden fazla adımda doğrulayın.
• Low, Medium, High ve Ultra düşünme modlarıyla arama ve akıl yürütme derinliğini sorunun karmaşıklığına göre ayarlayın.

🌱 Azaltılmış halüsinasyonlarla temellendirilmiş alıntılar

• İnsan müdahalesine olanak tanıyan metin parçalama görselleştirmesi.
• Temellendirilmiş yanıtları desteklemek için anahtar referansların hızlı görüntülenmesi ve izlenebilir alıntılar.

🍔 Heterojen veri kaynaklarıyla uyumluluk

• Word belgelerini, PowerPoint sunumlarını, Excel tablolarını, TXT dosyalarını, görselleri, PDF'leri, taranmış kopyaları, yapılandırılmış verileri, web sayfalarını ve daha fazlasını destekler.

🛀 Otomatik ve zahmetsiz RAG iş akışı

• Hem bireysel hem de büyük işletmeler için özelleştirilmiş kolaylaştırılmış RAG düzenlemesi.
• Yapılandırılabilir LLM'ler ve gömme (embedding) modelleri.
• Birleştirilmiş yeniden sıralama ile çoklu geri çağırma.
• İş süreçlerine sorunsuz entegrasyon için sezgisel API'ler.

🔎 Sistem Mimarisi

🏠 Yerel Dağıtım

Docker hızlı değerlendirme, entegrasyon testi ve üretim; kaynak kod ise geliştirme ve hata ayıklama için uygundur. Docker Go gerektirmez. Kaynak kod go.mod içindeki Go sürümünü, ön yüz ise Node.js ve npm'i gerektirir.

🐳 Docker Dağıtımı

📝 Ön Koşullar

• Önerilen başlangıç yapılandırması: 4 CPU çekirdeği, 16 GB RAM ve 50 GB boş disk alanı.
• Docker ≥ 24.0.0, Docker Compose ≥ v2.26.1.

🚀 Sunucuyu Başlatma

1. Elasticsearch kullanıyorsanız Docker ana makinesinde vm.max_map_count değerini en az 262144 olarak ayarlayın. Infinity kullanılırken bu adım genellikle gerekli değildir:

   vm.max_map_count değerini kontrol etmek için:

   sysctl vm.max_map_count

   Elasticsearch kullanıyorsanız ve değer 262144'in altındaysa sıfırlayın:

   # Bu örnekte 262144 olarak ayarlıyoruz:
   sudo sysctl -w vm.max_map_count=262144

   Bu değişiklik sistem yeniden başlatıldığında sıfırlanacaktır. Değişikliğin kalıcı olmasını sağlamak için /etc/sysctl.conf dosyasındaki vm.max_map_count değerini buna göre ekleyin veya güncelleyin:

   vm.max_map_count=262144

2. git clone https://github.com/infiniflow/ragflow.git

3. Docker:

   cd ragflow/docker
   git checkout v1.0.0-rc2
   docker compose -f docker-compose.yml up -d

4. Hizmet durumunu ve API hazırlığını kontrol edin:

   curl -f http://localhost/api/v1/system/healthz
   docker logs --tail 50 ragflow-cpu

5. Tarayıcıda http://IP_OF_YOUR_MACHINE adresini açıp oturum açın. Varsayılan yapılandırmada HTTP bağlantı noktası 80 yazılmayabilir.

6. Model sağlayıcıları sayfasında LLM, Embedding ve Reranker ekleyin. Ayrıntılar için llm_api_key_setup sayfasına bakın.

Ayrıntılar için hızlı başlangıç kılavuzuna bakın.

⚙️ Docker Yapılandırması ve Ayarlama

docker/.env ve docker/docker-compose.yml dosyalarını kullanın. Docker yapılandırmasına ve imaj oluşturma ve platform desteğine bakın. macOS şu anda desteklenmemektedir.

🔨 Kaynaktan Başlatma

📝 Ön Koşullar

1. Depoyu klonlayın ve go.mod içindeki Go sürümünü, Clang 20, LLD 20, CMake ≥ 4.0, PCRE2 ve CGO için gereken yerel kitaplıkları yükleyin.

   git clone https://github.com/infiniflow/ragflow.git
   cd ragflow

2. Go derlemesinin bağladığı yerel statik kitaplıkları (download_dev_deps.py) ve backend'in çalışma zamanında yüklediği model / tokenizer kaynaklarını (download_deps.py) hazırlamak için bağımlılık indirme betiklerini çalıştırın:

   uv run tools/scripts/download_dev_deps.py
   uv run ragflow_deps/download_deps.py

   download_dev_deps.py, pdfium, pdf_oxide, office_oxide ve onnxruntime'ı ~/ragflow-native-libs altına indirir ve açar; download_deps.py, cl100k sözlüğünü, DeepDoc modellerini ve gömme tokenizer varlıklarını ragflow_deps/ altına indirir. İkisi de Python betiğidir; uv run, bildirilen bağımlılıkları (requests ve model ile tokenizer indirmeleri için huggingface-hub) otomatik olarak kurar. Aynı kaynakları başka şekilde hazırladıysanız bu adımı atlayın. Depo kökünden başlatıldığında Go hizmetleri internal/rag/res/deepdoc dizinini otomatik bulur; başka bir dizinden başlatmak için DEEPDOC_MODEL_DIR değişkenini o dizinin mutlak yoluna ayarlayın.

3. Hizmetleri derleyin:

   ./build.sh --all

4. Yerel bağımlılıkları başlatın:

   sudo sysctl -w vm.max_map_count=262144
   docker compose --env-file docker/.env -f docker/docker-compose-base.yml up -d --wait es01 mysql minio nats kvrocks

5. Veritabanını geçirin:

   ./bin/ragflow_server --migrate

6. Dört hizmeti dört terminalde başlatın:

   Terminal 1: Admin (9381).

   ./bin/ragflow_server --admin

   ./bin/ragflow_server --ingestor

   Terminal 3: Syncer.

   ./bin/ragflow_server --syncer

   Terminal 4: API (9380).

   ./bin/ragflow_server --api

7. Yalnızca ön yüz geliştirmede Node.js ve npm'i yükleyip API'yi doğrulayın:

   cd web
   npm install
   curl -f http://127.0.0.1:9380/api/v1/system/healthz

Ayrıntılar için Kaynaktan Başlatma belgesine bakın.

İşletim notları: Elasticsearch ayarını kalıcı yapmak için /etc/sysctl.conf dosyasına vm.max_map_count=262144 ekleyin. Varsayılan MySQL yapılandırmasında Docker giriş noktası Admin, Syncer, Ingestor ve API'den önce geçişi çalıştırır. Açık kaynak 1.0'da DeepDoc düzen, OCR ve tablo tanıma için CPU kullanır. Docker değişikliklerinden sonra hizmetleri yeniden başlatın ve verileri korumak veya kaldırmak için Docker kılavuzunu izleyin. download_dev_deps.py yerel kitaplıkları, download_deps.py modelleri ve tokenizer kaynaklarını hazırlar; ikisi de uv run ile çalıştırılır. --migrate geçişi çalıştırıp çıkar; --admin yönetim hizmetini, --ingestor veri alma hizmetini, --syncer harici veri kaynağı eşitleme hizmetini ve --api Web UI ile SDK'lara yönelik API hizmetini başlatır. HTTP 200 API'nin hazır olduğunu gösterir.

📚 Dokümantasyon

• Hızlı Başlangıç
• Yapılandırma
• Sürüm Notları
• Kullanıcı Kılavuzları
• Geliştirici Kılavuzları
• Referanslar
• SSS

📜 Yol Haritası

RAGFlow Yol Haritası 2026 sayfasına bakın.

🏄 Topluluk

• Discord
• X
• GitHub Tartışmalar

🙌 Katkıda Bulunma

RAGFlow, açık kaynak iş birliği sayesinde gelişmektedir. Bu anlayışla, topluluktan gelen çeşitli katkıları benimsiyoruz. Bir parçası olmak istiyorsanız, önce Katkıda Bulunma Kılavuzumuzu inceleyin.