🛡️ Stop Coding Until You Do These 2 Things (A RAG Developer's Horror Story)

sharansh pandey — Wed, 11 Feb 2026 17:19:58 +0000

The TL;DR: I broke my project so you don't have to. Here is why Git and Isolation are your best friends.

What Happened: I was building a high-precision RAG engine (Research-OS). I got cocky. I didn't isolate my environment. I wasn't committing regularly. One pip install later, my project was a graveyard of "ModuleNotFoundError."

The "Anti-Fraud" Checklist for your Repo:

Isolate or Die: Use virtual environments. If you aren't isolated, you're just waiting for a conflict to happen.

Git is a Save Button: Use it like one. Big change? New branch. Small fix? Atomic commit.

Manage the Mess: A messy repo leads to messy logic. Use a clear structure (src/, tests/, docs/) to keep your head clear.

Final Thought: Don't toot your own horn—let your commit history do it for you. A clean repo is the mark of a professional.

Research Orchestration System (R-OS)

sharansh pandey — Tue, 10 Feb 2026 20:34:13 +0000

Building a "chat with your PDF" tool is a common entry point into AI, but the real challenge lies in making it reliable under hardware constraints. I’ve spent the last few months developing Research-OS (R-OS), a retrieval-augmented generation (RAG) system designed to handle complex academic papers locally on a 16GB RAM machine.

In this first post, I want to share the architectural decisions I made after a significant environment failure taught me the importance of dependency isolation and resource-efficient modeling.

The Core Tech Stack:

Vector Engine: FAISS for efficient similarity search.

Embeddings: FastEmbed (chosen for its low memory footprint compared to standard transformers).

Orchestration: FastAPI for a decoupled backend-frontend communication.

Logic: A hybrid retrieval system combining BM25 and vector-based search.

R-OS isn't just about calling an LLM API; it’s about the pipeline—how we ingest data, manage chunks, and verify that the retrieved context actually answers the user's query without hallucinating.

Github Link : https://github.com/sharansh-22/Research-OS

DEV Community: sharansh pandey

🛡️ Stop Coding Until You Do These 2 Things (A RAG Developer's Horror Story)

Research Orchestration System (R-OS)