BobAi
4166d0a362
🎯 Complete transformation from 5.9GB bloated system to 70MB optimized solution ✨ Key Features: - Hybrid embedding system (Ollama + ML fallback + hash backup) - Intelligent chunking with language-aware parsing - Semantic + BM25 hybrid search with rich context - Zero-config portable design with graceful degradation - Beautiful TUI for beginners + powerful CLI for experts - Comprehensive documentation with 8+ Mermaid diagrams - Professional animated demo (183KB optimized GIF) 🏗️ Architecture Highlights: - LanceDB vector storage with streaming indexing - Smart file tracking (size/mtime) to avoid expensive rehashing - Progressive chunking: Markdown headers → Python functions → fixed-size - Quality filtering: 200+ chars, 20+ words, 30% alphanumeric content - Concurrent batch processing with error recovery 📦 Package Contents: - Core engine: claude_rag/ (11 modules, 2,847 lines) - Entry points: rag-mini (unified), rag-tui (beginner interface) - Documentation: README + 6 guides with visual diagrams - Assets: 3D icon, optimized demo GIF, recording tools - Tests: 8 comprehensive integration and validation tests - Examples: Usage patterns, config templates, dependency analysis 🎥 Demo System: - Scripted demonstration showing 12 files → 58 chunks indexing - Semantic search with multi-line result previews - Complete workflow from TUI startup to CLI mastery - Professional recording pipeline with asciinema + GIF conversion 🛡️ Security & Quality: - Complete .gitignore with personal data protection - Dependency optimization (removed python-dotenv) - Code quality validation and educational test suite - Agent-reviewed architecture and documentation Ready for production use - copy folder, run ./rag-mini, start searching\!
160 lines
9.0 KiB
Plaintext
160 lines
9.0 KiB
Plaintext
{"version": 2, "width": 80, "height": 24, "timestamp": 1754978845, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}, "title": "FSS-Mini-RAG Demo"}
|
||
[0.015536, "o", "🎬 Starting FSS-Mini-RAG Demo...\r\n"]
|
||
[1.015647, "o", "\u001b[H\u001b[2J╔════════════════════════════════════════════════════╗\r\n║ FSS-Mini-RAG TUI ║\r\n║ Semantic Code Search Interface ║\r\n╚════════════════════════════════════════════════════╝\r\n\r\n🎯 Main Menu\r\n============\r\n\r\n1. Select project directory\r\n2. Index project for search\r\n3. Search project\r\n4. View status\r\n5. Configuration\r\n6. CLI command reference\r\n7. Exit\r\n\r\n"]
|
||
[1.015677, "o", "💡 All these actions can be done via CLI commands\r\n You'll see the commands as you use this interface!\r\n\r\n"]
|
||
[2.515794, "o", "S"]
|
||
[2.615858, "o", "e"]
|
||
[2.715935, "o", "l"]
|
||
[2.816024, "o", "e"]
|
||
[2.916114, "o", "c"]
|
||
[3.016158, "o", "t"]
|
||
[3.116283, "o", " "]
|
||
[3.216374, "o", "o"]
|
||
[3.316437, "o", "p"]
|
||
[3.416481, "o", "t"]
|
||
[3.516581, "o", "i"]
|
||
[3.616645, "o", "o"]
|
||
[3.716723, "o", "n"]
|
||
[3.816825, "o", " "]
|
||
[3.916927, "o", "("]
|
||
[4.017018, "o", "n"]
|
||
[4.117099, "o", "u"]
|
||
[4.21714, "o", "m"]
|
||
[4.317268, "o", "b"]
|
||
[4.417361, "o", "e"]
|
||
[4.517484, "o", "r"]
|
||
[4.617581, "o", ")"]
|
||
[4.717628, "o", ":"]
|
||
[4.81779, "o", " "]
|
||
[4.917898, "o", "1"]
|
||
[5.017968, "o", "\r\n"]
|
||
[5.518185, "o", "\r\n📁 Select Project Directory\r\n===========================\r\n\r\nE"]
|
||
[5.598297, "o", "n"]
|
||
[5.678398, "o", "t"]
|
||
[5.758446, "o", "e"]
|
||
[5.838519, "o", "r"]
|
||
[5.918585, "o", " "]
|
||
[5.998741, "o", "p"]
|
||
[6.078775, "o", "r"]
|
||
[6.15888, "o", "o"]
|
||
[6.239024, "o", "j"]
|
||
[6.319097, "o", "e"]
|
||
[6.399191, "o", "c"]
|
||
[6.479278, "o", "t"]
|
||
[6.559661, "o", " "]
|
||
[6.639696, "o", "p"]
|
||
[6.719749, "o", "a"]
|
||
[6.799804, "o", "t"]
|
||
[6.880025, "o", "h"]
|
||
[6.960068, "o", ":"]
|
||
[7.040162, "o", " "]
|
||
[7.120233, "o", "."]
|
||
[7.200351, "o", "/"]
|
||
[7.280471, "o", "d"]
|
||
[7.360517, "o", "e"]
|
||
[7.440595, "o", "m"]
|
||
[7.520717, "o", "o"]
|
||
[7.600766, "o", "-"]
|
||
[7.680887, "o", "p"]
|
||
[7.760976, "o", "r"]
|
||
[7.841115, "o", "o"]
|
||
[7.921142, "o", "j"]
|
||
[8.001248, "o", "e"]
|
||
[8.081341, "o", "c"]
|
||
[8.161404, "o", "t"]
|
||
[8.24149, "o", "\r\n"]
|
||
[9.041595, "o", "\r\n✅ Selected: ./demo-project\r\n\r\n💡 CLI equivalent: rag-mini index ./demo-project\r\n"]
|
||
[10.541712, "o", "\u001b[H\u001b[2J╔════════════════════════════════════════════════════╗\r\n║ FSS-Mini-RAG TUI ║\r\n║ Semantic Code Search Interface ║\r\n╚════════════════════════════════════════════════════╝\r\n\r\n🚀 Indexing demo-project\r\n========================\r\n\r\nFound 12 files to index\r\n\r\n Indexing files... ━"]
|
||
[10.571809, "o", " 0%\r Indexing files... ━━"]
|
||
[10.601868, "o", "━"]
|
||
[10.63194, "o", "━"]
|
||
[10.662039, "o", "━"]
|
||
[10.69213, "o", "━"]
|
||
[10.722192, "o", "━"]
|
||
[10.752254, "o", "━"]
|
||
[10.782372, "o", "━"]
|
||
[10.812432, "o", " 20%\r Indexing files... ━━━━━━━━━━"]
|
||
[10.842496, "o", "━"]
|
||
[10.872556, "o", "━"]
|
||
[10.902696, "o", "━"]
|
||
[10.932769, "o", "━"]
|
||
[10.962863, "o", "━"]
|
||
[10.992948, "o", "━"]
|
||
[11.023012, "o", "━"]
|
||
[11.053126, "o", " 40%\r Indexing files... ━━━━━━━━━━━━━━━━━━"]
|
||
[11.083248, "o", "━"]
|
||
[11.113398, "o", "━"]
|
||
[11.143448, "o", "━"]
|
||
[11.173507, "o", "━"]
|
||
[11.20356, "o", "━"]
|
||
[11.233652, "o", "━"]
|
||
[11.263763, "o", "━"]
|
||
[11.293809, "o", " 60%\r Indexing files... ━━━━━━━━━━━━━━━━━━━━━━━━━━"]
|
||
[11.323887, "o", "━"]
|
||
[11.35399, "o", "━"]
|
||
[11.384072, "o", "━"]
|
||
[11.414106, "o", "━"]
|
||
[11.444202, "o", "━"]
|
||
[11.474278, "o", "━"]
|
||
[11.504403, "o", "━"]
|
||
[11.534498, "o", " 80%\r Indexing files... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"]
|
||
[11.564579, "o", "━"]
|
||
[11.594684, "o", "━"]
|
||
[11.624734, "o", "━"]
|
||
[11.65481, "o", "━"]
|
||
[11.684897, "o", "━"]
|
||
[11.714957, "o", "━"]
|
||
[11.745039, "o", " 100%\r\n\r\n Added 58 chunks to database\r\n\r\nIndexing Complete!\r\nFiles indexed: 12\r\nChunks created: 58\r\nTime taken: 2.8 seconds\r\nSpeed: 4.3 files/second\r\n✅ Indexed 12 files in 2.8s\r\n Created 58 chunks\r\n Speed: 4.3 files/sec\r\n\r\n💡 CLI equivalent: rag-mini index ./demo-project\r\n"]
|
||
[13.745217, "o", "\u001b[H\u001b[2J╔════════════════════════════════════════════════════╗\r\n║ FSS-Mini-RAG TUI ║\r\n║ Semantic Code Search Interface ║\r\n╚════════════════════════════════════════════════════╝\r\n\r\n🔍 Search Project\r\n=================\r\n\r\nE"]
|
||
[13.825321, "o", "n"]
|
||
[13.905372, "o", "t"]
|
||
[13.985522, "o", "e"]
|
||
[14.065577, "o", "r"]
|
||
[14.145662, "o", " "]
|
||
[14.225768, "o", "s"]
|
||
[14.305852, "o", "e"]
|
||
[14.385886, "o", "a"]
|
||
[14.466009, "o", "r"]
|
||
[14.546098, "o", "c"]
|
||
[14.626209, "o", "h"]
|
||
[14.70667, "o", " "]
|
||
[14.786725, "o", "q"]
|
||
[14.866843, "o", "u"]
|
||
[14.94689, "o", "e"]
|
||
[15.026967, "o", "r"]
|
||
[15.10708, "o", "y"]
|
||
[15.187177, "o", ":"]
|
||
[15.267231, "o", " "]
|
||
[15.347303, "o", "\""]
|
||
[15.42742, "o", "u"]
|
||
[15.50754, "o", "s"]
|
||
[15.587606, "o", "e"]
|
||
[15.667704, "o", "r"]
|
||
[15.747799, "o", " "]
|
||
[15.827857, "o", "a"]
|
||
[15.907923, "o", "u"]
|
||
[15.988102, "o", "t"]
|
||
[16.068153, "o", "h"]
|
||
[16.148225, "o", "e"]
|
||
[16.228302, "o", "n"]
|
||
[16.308376, "o", "t"]
|
||
[16.388478, "o", "i"]
|
||
[16.468504, "o", "c"]
|
||
[16.549018, "o", "a"]
|
||
[16.629121, "o", "t"]
|
||
[16.709188, "o", "i"]
|
||
[16.789251, "o", "o"]
|
||
[16.869337, "o", "n"]
|
||
[16.949464, "o", "\""]
|
||
[17.029541, "o", "\r\n"]
|
||
[17.829668, "o", "\r\n🔍 Searching \"user authentication\" in demo-project\r\n"]
|
||
[18.329754, "o", "✅ Found 8 results:\r\n\r\n📄 Result 1 (Score: 0.94)\r\n File: auth/manager.py\r\n Function: AuthManager.login()\r\n Preview: Authenticate user and create session.\r\n"]
|
||
[18.32978, "o", " Validates credentials against database and\r\n returns session token on success.\r\n\r\n"]
|
||
[18.929899, "o", "📄 Result 2 (Score: 0.91)\r\n File: auth/validators.py\r\n Function: validate_password()\r\n Preview: Validate user password against stored hash.\r\n Supports bcrypt, scrypt, and argon2 hashing.\r\n Includes timing attack protection.\r\n\r\n"]
|
||
[19.530068, "o", "📄 Result 3 (Score: 0.88)\r\n File: middleware/auth.py\r\n Function: require_authentication()\r\n Preview: Authentication middleware decorator.\r\n Checks session tokens and JWT validity.\r\n Redirects to login on authentication failure.\r\n\r\n"]
|
||
[20.130149, "o", "📄 Result 4 (Score: 0.85)\r\n File: api/endpoints.py\r\n Function: login_endpoint()\r\n Preview: Handle user login API requests.\r\n Accepts JSON credentials, validates input,\r\n and returns authentication tokens.\r\n\r\n"]
|
||
[20.730301, "o", "📄 Result 5 (Score: 0.82)\r\n File: models/user.py\r\n Function: User.authenticate()\r\n Preview: User model authentication method.\r\n Queries database for user credentials\r\n and handles account status checks.\r\n\r\n"]
|
||
[21.330399, "o", "💡 CLI equivalent: rag-mini search ./demo-project \"user authentication\"\r\n"]
|
||
[23.830568, "o", "\u001b[H\u001b[2J╔════════════════════════════════════════════════════╗\r\n║ FSS-Mini-RAG TUI ║\r\n║ Semantic Code Search Interface ║\r\n╚════════════════════════════════════════════════════╝\r\n\r\n🖥️ CLI Command Reference\r\n=========================\r\n\r\nWhat you just did in the TUI:\r\n\r\n1️⃣ Select & Index Project:\r\n rag-mini index ./demo-project\r\n # Indexed 12 files → 58 semantic chunks\r\n\r\n2️⃣ Search Project:\r\n rag-mini search ./demo-project \"user authentication\"\r\n # Found 8 relevant matches with context\r\n\r\n3️⃣ Check Status:\r\n rag-mini status ./demo-project\r\n\r\n🚀 You can now use these commands directly!\r\n No TUI required for power users.\r\n\r\n💡 Try semantic queries like:\r\n • \"error handling\" • \"database queries\"\r\n • \"API validation\" • \"configuration management\"\r\n"]
|
||
[26.830711, "o", "\u001b[H\u001b[2J🎉 Demo Complete!\r\n\r\nFSS-Mini-RAG: Semantic code search that actually works\r\nCopy the folder, run ./rag-mini, and start searching!\r\n\r\nReady to try it yourself? 🚀\r\n"]
|