Flamehaven FileSearch
lastmod 2026-11-16created 2025-11-143 edits
FLAMEHAVEN FileSearch는 Python 과 FastAPI 로 만든 셀프 호스팅 RAG 문서 검색 엔진이다. 문서를 외부 서비스에 맡기지 않고 자기 서버에 올려 두고, 키워드·시맨틱·하이브리드 검색과 LLM 답변을 함께 제공한다. 임베딩은 ML 프레임워크 없이 자체 DSP v2.0 으로 만들고, 답변을 생성하는 LLM 은 환경 변수 하나로 Gemini, Ollama, OpenAI, Anthropic 가운데 고른다.
About
- Docker 이미지 하나로 띄우거나 Python SDK, REST API 로 씀. PyPI 패키지는
flamehaven-filesearch - 검색은 키워드, 시맨틱, BM25+RRF 하이브리드 세 가지이고 오타 자동 교정이 붙음. 하이브리드 결과에 신뢰도 점수를 매겨 낮으면 키워드 검색으로 보강하거나
low_confidence로 표시함 - PDF, DOCX, XLSX, PPTX, RTF, HTML, CSV, LaTeX, WebVTT, 이미지(OCR) 등 34개 파일 형식을 파싱함. 문서 구조를 따라 청크를 나누고, 답변마다 출처 문서와 청크를 연결함
- Obsidian 볼트용 모드는 frontmatter, 별칭, 태그, 위키링크를 읽어 노트 단위로 색인함
- 기본 LLM 은 Google Gemini 파일 검색 API. Ollama 로 Gemma·Llama·Qwen 등을 돌리면 완전히 로컬에서 동작하고, vLLM·LM Studio 같은 OpenAI 호환 엔드포인트도 붙음
- 저장소는 기본 SQLite 이고 PostgreSQL+pgvector, Redis 캐시를 선택적으로 씀. HNSW 벡터 인덱스는 추가 설치 옵션
- LangChain, LlamaIndex, Haystack, CrewAI 어댑터 제공
- API 키는 SHA256+salt 로 해시해 저장하고 OAuth2/OIDC, 키별 요청 제한(기본 분당 100회), 감사 로그를 지원함
- README 의 측정치: Apple M1·16GB 에서 PDF 500개(약 2GB) 기준 캐시 적중 검색 9ms, Gemini 호출이 포함된 검색 1,250ms
- MIT 라이선스