vintage-wiki-rag ⌨️

A retrieval-augmented generation (RAG) app for exploring vintage mechanical keyboard knowledge.
Built on embeddings + FAISS vector search, it lets you query the Mechanical Keyboard Club Wiki (the community-driven successor to Deskthority).

demo.mp4

---

🔎 Current Features

• Indexed ~160 Alps Electric switch pages (e.g. SKCL, SKCM, plate spring, magnetic reed).
• Fast semantic search with top-k ranked answers.
• Streamlit UI + FastAPI backend, linking directly to source wiki pages.

🚧 Working On

• Expanding to Cherry switches -> full keyboard data (~3,000 pages).
• Adding evaluation metrics (Recall@k, MRR) for retrieval quality.
• Enabling broader RAG workflows (answer synthesis, citations).
• Working on ReAct (Reason + Action) style model using Nvidia's Nemotron model

---

🛠️ Tech Stack

• Python, Streamlit, FastAPI
• SentenceTransformers for embeddings
• FAISS for vector search