[FEAT]: Developer setup guide and enhanced CONTRIBUTING.md

[kasimlohar]

📝 Description

New contributors currently lack a comprehensive setup guide. The CONTRIBUTING.md lists prerequisites (Docker, Compose, Make) but stops without providing actual setup steps. The docs/ directory has only db.md and docker.md — there is no cross-platform developer onboarding guide.

💡 Rationale

Multiple issues report setup-related problems that could be prevented with better documentation:

• Facing error while setting up repository for first time users #77 — libGL.so.1 missing dependency
• Docker build fails with libGL.so.1 not found error #184 — Docker environment setup confusion
• [BUG]: Docker container missing OpenCV dependencies - ImportError on startup #191 — Container configuration issues
• [BUG]: python-multipart and pypdf missing from requirements.txt  #204 — python-multipart not listed in requirements.txt
• [BUG]: Docker Environment Fails to Start API (Missing libGL and Port mapping) #224 — Port 8000 not mapped in docker-compose.yml

A central setup guide consolidating these solutions would reduce repeated issue filings and help new contributors get started faster.

🛠️ Proposed Solution

1. Enhance CONTRIBUTING.md — add development setup instructions, testing commands (pytest), branch naming conventions (feat/, fix/, docs/), commit message guidelines, project structure overview, and useful links.
2. Create docs/SETUP.md — comprehensive cross-platform (Windows, macOS, Linux) setup guide with:
   • Docker setup (5 steps) and local setup (6 steps)
   • Environment variable reference (OLLAMA_HOST, PYTHONPATH)
   • 6 common errors with fixes, each linked to the relevant issue
   • Database reset instructions
   • Architecture pipeline overview

• Documentation update in docs/
• Update to CONTRIBUTING.md

✅ Acceptance Criteria

• CONTRIBUTING.md includes Quick Start steps for both Docker and local development
• docs/SETUP.md covers Windows, macOS, and Linux setup
• Common errors reference their corresponding GitHub issues
• All internal and external links resolve correctly

📌 Additional Context

Documentation-only changes — no application code is modified.

[RITVIKKAMASETTY]

@kasimlohar I think the maintainer told the repo is still being setup for gsoc 2026
so I think we need to take opinion from mentors

[kasimlohar]

Thanks @RITVIKKAMASETTY!
Yep, aware of that
this is just a docs-only PR to help with common setup issues. No rush to merge.

[ishansurdi]

Quick question — does this repo have a dedicated Discord or Slack channel for communication?