4 Commits

Author SHA1 Message Date
f4115e83bd Enhance model resolution system and improve user experience
Key improvements:
- Implement relaxed model matching to handle modern naming conventions (e.g., qwen3:4b-instruct-2507-q4_K_M)
- Add smart auto-selection prioritizing Qwen3 series over older models
- Replace rigid pattern matching with flexible base+size matching
- Add comprehensive logging for model resolution transparency
- Introduce new 'models' command for detailed model status reporting
- Improve pip installation feedback with progress indication
- Fix Python syntax warning in GitHub template script

The enhanced system now provides clear visibility into model selection
decisions and gracefully handles various model naming patterns without
requiring complex configuration.
2025-09-03 00:09:39 +10:00
930f53a0fb Major code quality improvements and structural organization
- 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.
2025-08-28 15:29:54 +10:00
7d2fe8bacd Create comprehensive GitHub template system with auto-update
🚀 Complete GitHub Template System:
• GitHub Actions workflows (CI, release, template-sync)
• Auto-update system integration for all projects
• Privacy-first approach (private repos by default)
• One-command setup script for easy migration
• Template synchronization for keeping repos updated

🔧 Components Added:
• .github/workflows/ - Complete CI/CD pipeline
• scripts/setup-github-template.py - Template setup automation
• scripts/quick-github-setup.sh - One-command project setup
• Comprehensive documentation and security guidelines

🔒 Privacy & Security:
• Private repositories by default
• Minimal permissions for workflows
• Local-only data processing
• No telemetry or tracking
• User consent for all operations

🎯 Perfect for Gitea → GitHub migration:
• Preserves auto-update functionality
• Professional development workflows
• Easy team collaboration
• Automated release management

Usage: ./scripts/quick-github-setup.sh . -o username -n project-name
2025-08-15 15:37:16 +10:00
2f2dd6880b Add comprehensive LLM provider support and educational error handling
 Features:
- Multi-provider LLM support (OpenAI, Claude, OpenRouter, LM Studio)
- Educational config examples with setup guides
- Comprehensive documentation in docs/LLM_PROVIDERS.md
- Config validation testing system

🎯 Beginner Experience:
- Friendly error messages for common mistakes
- Educational explanations for technical concepts
- Step-by-step troubleshooting guidance
- Clear next-steps for every error condition

🛠 Technical:
- Extended LLMConfig dataclass for cloud providers
- Automated config validation script
- Enhanced error handling in core components
- Backward-compatible configuration system

📚 Documentation:
- Provider comparison tables with costs/quality
- Setup instructions for each LLM provider
- Troubleshooting guides and testing procedures
- Environment variable configuration options

All configs pass validation tests. Ready for production use.
2025-08-14 16:39:12 +10:00