Flamehaven FileSearch — Self-host edilebilir açık kaynak RAG belge arama motoru

(github.com/flamehaven01)

29 puan yazan flamehaven01 2025-11-13 | Henüz yorum yok. | WhatsApp'ta paylaş

🔥Flamehaven FileSearch

Flamehaven FileSearch, herkesin 5 dakika içinde belge tabanlı bir RAG (Retrieval-Augmented Generation) sistemi kurabilmesini sağlayan, self-host edilebilir açık kaynak semantik arama motorudur.
Python, FastAPI ve SQLite tabanlı olarak çalışır; Google Gemini Embedding'i kullanarak PDF/DOCX/TXT/MD gibi çeşitli belgelerde doğal dilde soru-cevap gerçekleştirir.

Neden yapıldı?

Açık kaynak RAG uygulamalarının çoğu Colab veya Jupyter ortamlarında iyi çalışsa da, gerçek bir sunucuya kurup işletmek için yapıları karmaşık olabiliyor ya da yeterli kararlılık sunmuyor.
Flamehaven FileSearch, “gerçekte çalışan hafif bir RAG yığını” hedefiyle; araştırmacıların, startup'ların ve bireysel geliştiricilerin kendi verileriyle semantik aramayı anında deneyebilmesi için tasarlandı.

Neden dikkat çekiyor?

Tam özerklik: Harici sunuculara veya buluta bağımlı değildir; tüm veriler yerelde saklanır.
Geliştirici odaklı yapı: Python SDK + REST API, FastAPI tabanlı otomatik Swagger dokümantasyonu sunar.
PyPI paketi yayını: PyPI üzerinden doğrudan kurulabilir — pip install flamehaven-filesearch[api] ile tek satırda tam otomatik kurulum.
Anında çalıştırma: Kurulum sonrası flamehaven-api komutuyla sunucuyu hemen başlatabilir, tarayıcıda /docs ile API'yi test edebilirsiniz.
Genişletilebilirlik: SQLite depolama, eklenti mimarisi, Docker dağıtım desteği.
Eğitim/araştırma dostu: Gemini embedding kullanarak en güncel LLM tabanlı semantik arama pratikleri için idealdir.

Neler içeriyor? (Öne çıkanlar)

Python SDK: from flamehaven_filesearch import FlamehavenFileSearch

→ Belge yükleme / arama / store yönetimi dahil tüm işlevleri sunar.
REST API: /upload, /search, /stores endpoint'leri + Swagger UI.
Docker desteği: docker run -e GEMINI_API_KEY=... -p 8000:8000 flamehaven/filesearch:latest
Yapı: core(engine) / api(FastAPI) / data(SQLite) / examples / docs

Hızlıca deneyin

1️⃣ PyPI paketi

Flamehaven FileSearch, PyPI üzerinden doğrudan kurulabilir.

En güncel sürüm: https://pypi.org/project/flamehaven-filesearch

pip install flamehaven-filesearch[api]

2️⃣ Kurulum

pip install flamehaven-filesearch[api]  
export GEMINI_API_KEY="your-google-gemini-key"  
flamehaven-api

3️⃣ Belge yükleme ve arama

curl -X POST "http://localhost:8000/upload"; -F "file=@handbook.pdf"  
curl "http://localhost:8000/search?q=vacation+policy";

4️⃣ SDK kullanım örneği

from flamehaven_filesearch import FlamehavenFileSearch  
fs = FlamehavenFileSearch()  
fs.upload_file("handbook.pdf")  
print(fs.search("vacation policy")["answer"])

Performans ve özellikler

Ortam: Ubuntu 22.04 / 2vCPU / 4GB RAM / SSD
10MB PDF yükleme → yaklaşık 5 saniye
Ortalama arama yanıtı → 2 saniye (5 kaynak alıntılandığında)
Store silme/oluşturma → 1 saniyenin altında
Depolama ek yükü → belge boyutunun yaklaşık %5'i

Yol haritası

v1.1 : Önbellekleme ve kota yönetimi
v1.2 : Toplu arama + WebSocket streaming
v2.0 : Çok dilli belge desteği, analiz panosu
Gelecekte : Pinecone/Weaviate vektörDB entegrasyonu, OCR, ortak çalışma store'ları

Lisans

MIT License (tamamen açık kaynak)

🛡️ Flamehaven Github güvenlik ve hesap duyurusu

Kısa süre önce Flamehaven GitHub hesabında (bu hesap) şüpheli giriş denemeleri tespit edildi ve bunun sonucunda hesap askıya alındı. Sorunu doğrulamak için şu anda GitHub güvenlik ekibiyle birlikte çalışılıyor.

Bu olay nedeniyle dir2md, flashrecord, crom-efficient, Arr-medic-cyp3a4 gibi projeleri içeren hesap bir süreliğine kullanım dışı bırakılmış durumda.

Verilen rahatsızlıktan dolayı içtenlikle özür dileriz; güvenlik incelemesi tamamlanana kadar anlayışınızı rica ederiz.

Flamehaven FileSearch — Self-host edilebilir açık kaynak RAG belge arama motoru