IdeaCredIdeaCred

LEADisDEAD/Vector-Forge

48

Production-style Retrieval-Augmented Generation (RAG) system with FAISS-based semantic search, intent-aware retrieval, and fully local LLM inference.

What's novel

Production-style Retrieval-Augmented Generation (RAG) system with FAISS-based semantic search, intent-aware retrieval, and fully local LLM inference.

Code Analysis

9 files read · 3 rounds

A Flask-based RAG system that performs hybrid dense+sparse retrieval over uploaded documents, reranks with a cross-encoder, and generates citation-grounded answers via a local or API LLM.

Strengths

Clean layered architecture with genuine two-stage retrieval (FAISS IVF + BM25 fusion + cross-encoder reranking), well-structured prompt engineering for citation grounding, and dual LLM backend support. The code is readable, modular, and the retrieval pipeline is correctly implemented.

Weaknesses

No persistence (all in-memory), no real test suite (only a hardcoded evaluation script), critical nlist=1 bug defeats IVF indexing, unbounded answer cache, and no error handling around LLM calls or file operations. The 'production-style' README claim overstates the system's robustness.

Score Breakdown

Innovation
4 (25%)
Craft
42 (35%)
Traction
5 (15%)
Scope
51 (25%)

Signal breakdown

Innovation

Not Fork+1
Code Novelty+1
Concept Novelty+1

Craft

Ci+0
Tests+0
Polish+0
Releases+0
Has License+0
Code Quality+17
Readme Quality+15
Recent Activity+7
Structure Quality+5
Commit Consistency+2
Has Dependency Mgmt+5

Traction

Forks+0
Stars+6
Hn Points+0
Watchers+0
Early Traction+0
Devto Reactions+0
Community Contribs+0

Scope

Commits+7
Languages+5
Subsystems+5
Bloat Penalty+0
Completeness+6
Contributors+5
Authored Files+8
Readme Code Match+3
Architecture Depth+3
Implementation Depth+8

Evidence

Commits

22

Contributors

1

Files

14

Active weeks

3

TestsCI/CDREADMELicenseContributing

Repository

Language

Python

Stars

1

Forks

0

License