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\!
95 lines
7.7 KiB
Plaintext
95 lines
7.7 KiB
Plaintext
{"version": 2, "width": 80, "height": 24, "timestamp": 1754979250, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}, "title": "FSS-Mini-RAG Demo"}
|
||
[0.011606, "o", "🎬 Starting FSS-Mini-RAG Demo...\r\n"]
|
||
[1.01176, "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💡 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.511829, "o", "Select option (number): 1"]
|
||
[2.661937, "o", "\r\n"]
|
||
[3.16208, "o", "\r\n📁 Select Project Directory\r\n===========================\r\n\r\nProject path: ."]
|
||
[3.242164, "o", "/"]
|
||
[3.322277, "o", "d"]
|
||
[3.402373, "o", "e"]
|
||
[3.48261, "o", "m"]
|
||
[3.562708, "o", "o"]
|
||
[3.642797, "o", "-"]
|
||
[3.722867, "o", "p"]
|
||
[3.802932, "o", "r"]
|
||
[3.883013, "o", "o"]
|
||
[3.963122, "o", "j"]
|
||
[4.043202, "o", "e"]
|
||
[4.123291, "o", "c"]
|
||
[4.203361, "o", "t"]
|
||
[4.283471, "o", "\r\n"]
|
||
[5.083558, "o", "\r\n✅ Selected: ./demo-project\r\n\r\n💡 CLI equivalent: rag-mini index ./demo-project\r\n"]
|
||
[6.58369, "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... ━"]
|
||
[6.613858, "o", " 0%\r Indexing files... ━━"]
|
||
[6.643906, "o", "━"]
|
||
[6.673988, "o", "━"]
|
||
[6.704055, "o", "━"]
|
||
[6.734194, "o", "━"]
|
||
[6.764295, "o", "━"]
|
||
[6.794336, "o", "━"]
|
||
[6.824396, "o", "━"]
|
||
[6.854486, "o", " 20%\r Indexing files... ━━━━━━━━━━"]
|
||
[6.884556, "o", "━"]
|
||
[6.914641, "o", "━"]
|
||
[6.944706, "o", "━"]
|
||
[6.974775, "o", "━"]
|
||
[7.004943, "o", "━"]
|
||
[7.034989, "o", "━"]
|
||
[7.065051, "o", "━"]
|
||
[7.095135, "o", " 40%\r Indexing files... ━━━━━━━━━━━━━━━━━━"]
|
||
[7.125215, "o", "━"]
|
||
[7.155357, "o", "━"]
|
||
[7.185448, "o", "━"]
|
||
[7.215562, "o", "━"]
|
||
[7.245655, "o", "━"]
|
||
[7.275764, "o", "━"]
|
||
[7.305906, "o", "━"]
|
||
[7.33605, "o", " 60%\r Indexing files... ━━━━━━━━━━━━━━━━━━━━━━━━━━"]
|
||
[7.366182, "o", "━"]
|
||
[7.396217, "o", "━"]
|
||
[7.426311, "o", "━"]
|
||
[7.456404, "o", "━"]
|
||
[7.486499, "o", "━"]
|
||
[7.516563, "o", "━"]
|
||
[7.546637, "o", "━"]
|
||
[7.576718, "o", " 80%\r Indexing files... ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"]
|
||
[7.606811, "o", "━"]
|
||
[7.636918, "o", "━"]
|
||
[7.667002, "o", "━"]
|
||
[7.697063, "o", "━"]
|
||
[7.72716, "o", "━"]
|
||
[7.757317, "o", "━"]
|
||
[7.787329, "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"]
|
||
[9.787461, "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\nSearch query: \""]
|
||
[9.86757, "o", "u"]
|
||
[9.947634, "o", "s"]
|
||
[10.027763, "o", "e"]
|
||
[10.107854, "o", "r"]
|
||
[10.187948, "o", " "]
|
||
[10.268032, "o", "a"]
|
||
[10.348137, "o", "u"]
|
||
[10.428233, "o", "t"]
|
||
[10.508289, "o", "h"]
|
||
[10.588404, "o", "e"]
|
||
[10.668488, "o", "n"]
|
||
[10.748564, "o", "t"]
|
||
[10.828606, "o", "i"]
|
||
[10.908678, "o", "c"]
|
||
[10.988754, "o", "a"]
|
||
[11.068836, "o", "t"]
|
||
[11.148986, "o", "i"]
|
||
[11.229091, "o", "o"]
|
||
[11.309143, "o", "n"]
|
||
[11.389238, "o", "\""]
|
||
[11.469342, "o", "\r\n"]
|
||
[12.269425, "o", "\r\n🔍 Searching \"user authentication\" in demo-project\r\n"]
|
||
[12.76953, "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"]
|
||
[12.769549, "o", " Validates credentials against database and\r\n returns session token on success.\r\n\r\n"]
|
||
[13.369697, "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"]
|
||
[13.969821, "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"]
|
||
[14.569938, "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"]
|
||
[15.170064, "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"]
|
||
[15.770453, "o", "💡 CLI equivalent: rag-mini search ./demo-project \"user authentication\"\r\n"]
|
||
[18.270591, "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"]
|
||
[21.270814, "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"]
|