"Most search engines find files. SAMIndex understands logic."
I built SAMIndex because I was tired of "Keyword Blindness." As codebases grow, finding where something is becomes easier than understanding why it is. SAMIndex was created to bridge the Context Gap between raw code and developer intent.
- Keyword Blindness: Replaces traditional
grepsearches with Neural Understanding. You don't search for "auth middleware"; you ask "How does the system handle JWT rotation?". - Indexing Latency: Traditional API-based indexing is slow and hits rate limits. Our Turbo Indexing strategy uses ZIP-stream processing to bypass GitHub limits, indexing massive repos in seconds.
- Provider Lock-in: Engineered with a Dual-AI Engine that seamlessly switches between Google Gemini and NVIDIA NIM (Llama 3.1) based on your availability and performance needs.
| Principle | Implementation |
|---|---|
| Neural Understanding | Uses LLMs (Gemini/NVIDIA) to build a semantic brain of your code |
| Turbo Indexing | ZIP-based scanning to bypass GitHub API rate limits by 90% |
| Event-Driven Pipeline | BullMQ + Redis for resilient, asynchronous background indexing |
| Digital Obsidian UI | Premium glassmorphism design system with sub-100ms interaction latency |
| Workspace Isolation | Deep-search within specific repos or perform global neural queries |
| Identity-First Security | Passport.js Google OAuth + JWT rotation for senior-grade security |
|
🧠 Neural Intelligence
|
⚡ Turbo Infrastructure
|
|
🛡️ Security & Scalability
|
🎨 UX & Aesthetic
|
┌─────────────────────────────────────────────────────────────────────┐
│ CLIENT LAYER │
│ React 19 + Vite │ Framer Motion │ Lucide Icons │
└────────────────────────────┬────────────────────────────────────────┘
│ HTTPS / WSS
┌────────────────────────────▼────────────────────────────────────────┐
│ EXPRESS BACKEND │
│ REST API + Socket.IO Control Plane │
└──────────┬──────────────────────────────────────────┬──────────────┘
│ │
┌──────────▼──────────┐ ┌──────────▼──────────────┐
│ BullMQ Worker │ │ Neural Engine │
│ (Indexing Service) │ │ (Gemini / NVIDIA) │
└──────────┬──────────┘ └──────────┬──────────────┘
│ │
┌──────────▼──────────────────────────────────────────▼──────────────┐
│ DATA LAYER │
│ ┌─────────────┐ ┌─────────────┐ ┌──────────────────────────┐ │
│ │ MongoDB 9 │ │ Redis 7 │ │ GitHub API / ZIP │ │
│ │ (Neural │ │ (Queue, │ │ (Source Layer) │ │
│ │ Brain) │ │ Cache) │ │ │ │
│ └─────────────┘ └─────────────┘ └──────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
SAMIndex/
├── 📁 frontend/ # React + Vite (Digital Obsidian)
│ └── src/
│ ├── 📁 assets/ # Premium branding & logos
│ ├── 📁 components/ # Glassmorphism UI components
│ │ ├── Layout.jsx # App shell with backdrop blur
│ │ ├── Search/ # Neural search interface
│ │ └── Indexing/ # Progress bars & scan states
│ ├── 📁 hooks/ # Custom intelligence hooks
│ ├── 📁 pages/ # Dashboard, Repository, Settings
│ ├── 📁 services/ # API & WebSocket connectors
│ ├── index.css # Global Design Tokens
│ └── App.jsx # Root router
│
├── 📁 backend/ # Node.js + Express API
│ └── src/
│ ├── 📁 modules/ # Domain-Driven Design
│ │ ├── auth/ # Google OAuth & JWT
│ │ ├── repository/ # CRUD & Indexing logic
│ │ ├── search/ # Neural query processing
│ │ └── ai/ # Gemini & NVIDIA NIM adapters
│ ├── 📁 middleware/ # Security & Validation
│ ├── 📁 queues/ # BullMQ configuration
│ ├── 📁 workers/ # Background processing logic
│ ├── 📁 models/ # Mongoose (Neural Schema)
│ └── server.js # Entry point
│
├── 📁 assets/ # Global static assets
├── 📄 DEPLOYMENT.md # Deployment guide
├── 📄 .env.example # Config template
└── 📄 vercel.json # Frontend hosting config
| Technology | Purpose |
|---|---|
 |
UI Framework |
 |
Modern Build Tool |
 |
Atomic Styling |
 |
Premium Animations |
 |
3D Visual Mesh |
 |
Icon Suite |
| Technology | Purpose |
|---|---|
 |
JS Runtime |
 |
API Framework |
 |
Neural Persistence |
 |
Queue & Caching |
 |
Background Processing |
 |
Authentication |
| Technology | Purpose |
|---|---|
 |
Neural Core |
 |
Alternative Neural Engine |
 |
Edge Hosting |
 |
Backend Compute |
node >= 18.0.0
npm >= 9.0.0
MongoDB (Atlas or Local)
Redis (Upstash or Local)git clone https://github.com/syedmukheeth/SAMIndex.git
cd SAMIndex
# Install Backend
cd backend && npm install
# Install Frontend
cd ../frontend && npm installCreate a .env in the backend folder:
PORT=5000
MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_jwt_secret
GITHUB_TOKEN=your_github_token
GEMINI_API_KEY=your_key # Detects nvapi- prefix for NVIDIA NIM
REDIS_HOST=your_host
REDIS_PORT=your_port
REDIS_PASSWORD=your_password# In backend/
npm run dev
# In frontend/
npm run dev- ✅ JWT Rotation: Prevents session hijacking.
- ✅ Helmet.js: Hardened HTTP headers.
- ✅ Rate Limiting: Prevents brute-force indexing.
- ✅ NoSQL Sanitization: Protection against MongoDB injection.
- ✅ Google OAuth: Secure identity provider.
Built with 🖤 from India by
Syed Mukheeth
If SAMIndex helped you understand your code better, please ⭐ the repo!
© 2026 SAMIndex — A Neural Code Intelligence Experiment