- Applied Black formatter and isort across entire codebase for professional consistency
- Moved implementation scripts (rag-mini.py, rag-tui.py) to bin/ directory for cleaner root
- Updated shell scripts to reference new bin/ locations maintaining user compatibility
- Added comprehensive linting configuration (.flake8, pyproject.toml) with dedicated .venv-linting
- Removed development artifacts (commit_message.txt, GET_STARTED.md duplicate) from root
- Consolidated documentation and fixed script references across all guides
- Relocated test_fixes.py to proper tests/ directory
- Enhanced project structure following Python packaging standards
All user commands work identically while improving code organization and beginner accessibility.
CRITICAL UX FIXES for beginners:
Model Display Issues Fixed:
- TUI now shows ACTUAL configured model, not hardcoded model
- CLI status command shows configured vs actual model with mismatch warnings
- Both TUI and CLI use identical model selection logic (no more inconsistency)
Config File Visibility Improved:
- Config file location prominently displayed in TUI configuration menu
- CLI status shows exact config file path (.mini-rag/config.yaml)
- Added clear documentation in config file header about model settings
- Users can now easily find and edit YAML file for direct configuration
User Trust Restored:
- ✅ Shows 'Using configured: qwen3:1.7b' when config matches reality
- ⚠️ Shows 'Model mismatch!' when config differs from actual
- Config changes now immediately visible in status displays
No more 'I changed the config but nothing happened' confusion!
- Preserve whitespace and newlines in streaming responses
- Clean thinking tags from final LLM responses
- Add lazy initialization to _call_ollama method
- Improve Windows installer to handle existing virtual environments
- Add better error reporting for import failures
These fixes address formatting corruption in numbered lists and
improve installer reliability when dependencies already exist.
Major fixes:
- Fix model selection to prioritize qwen3:1.7b instead of qwen3:4b for testing
- Correct context length from 80,000 to 32,000 tokens (proper Qwen3 limit)
- Implement content-preserving safeguards instead of dropping responses
- Fix all test imports from claude_rag to mini_rag module naming
- Add virtual environment warnings to all test entry points
- Fix TUI EOF crash handling with proper error handling
- Remove warmup delays that were causing startup lag and unwanted model calls
- Fix command mappings between bash wrapper and Python script
- Update documentation to reflect qwen3:1.7b as primary recommendation
- Improve TUI box alignment and formatting
- Make language generic for any documents, not just codebases
- Add proper folder names in user feedback instead of generic terms
Technical improvements:
- Unified model rankings across all components
- Better error handling for missing dependencies
- Comprehensive testing and validation of all fixes
- All tests now pass and system is deployment-ready
All major crashes and deployment issues resolved.
- Added beautiful new Mini-RAG logo with teal and purple colors
- Updated README to use new logo
- Cleaned up repository by removing development scripts and artifacts
- Repository structure now clean and professional
- Ready for GitHub release preparation
- Changed primary model recommendation from qwen3:1.7b to qwen3:4b
- Added Q8 quantization info in technical docs for production users
- Fixed method name error: get_embedding_info() -> get_status()
- Updated all error messages and test files with new recommendations
- Maintained beginner-friendly options (1.7b still very good, 0.6b surprisingly good)
- Added explanation of why small models work well with RAG context
- Comprehensive testing completed - system ready for clean release
