Release v1.1.1: Gemini 2.x Upgrade & ReAct Architecture

🚀 Major Upgrade: Gemini 2.x Models & ReAct Architecture

This release brings critical updates to ensure compatibility with current Google Gemini API models and significantly improves research quality by adopting the proven ReAct (Reasoning and Acting) framework from the upstream web_research_agent project.

✨ Major Features

Updated Gemini Models:

• Primary model: gemini-2.0-flash (previously gemini-1.5-flash)
• Fallback model: gemini-2.5-flash (previously gemini-1.5-pro)
• Extended fallback chain: gemini-2.0-flash-001, gemini-2.5-flash-lite, gemini-2.5-pro
• Automatic migration of legacy model names in existing configurations

ReAct Architecture:

• Complete architectural upgrade adopting the ReAct framework from web_research_agent
• Improved reasoning and acting loop for better research quality
• Modular tool system with enhanced search and scrape capabilities
• Added pyproject.toml for modern Python packaging (PEP 621)

UI/UX Improvements:

• Fixed ASCII banner to correctly spell "ELIMU" (was displaying incorrectly)
• Enhanced console output and progress indicators
• Better handling of special characters in scraped content

🐛 Fixes

• Critical: Resolved 404 models/gemini-1.5-flash is not found errors
• Critical: Fixed 404 models/gemini-1.5-flash-8b is not found errors
• Fixed character encoding warnings when scraping Kenyan websites
• Improved error handling and retry logic with exponential backoff
• Enhanced model fallback mechanism for better reliability

🔧 Technical Changes

• Removed legacy agent/ directory (replaced by elimu_react/)
• Removed legacy tools/ directory (replaced by modular tool system)
• Updated config/config.py with new default models and migration logic
• Enhanced elimu_react/llm.py with robust model fallback
• Improved utils/formatters/formatters.py for better educational content generation

📚 Documentation

• Updated CHANGELOG.md with detailed version history
• Updated INSTALL_EDUCATORS.md with current installation instructions

🔄 Migration Notes

Existing users: Your configuration will be automatically migrated to the new model names on the next run. No manual action required!

Legacy model mapping:

• gemini-1.5-flash → gemini-2.0-flash
• gemini-1.5-flash-latest → gemini-2.0-flash
• gemini-1.5-flash-8b → gemini-2.0-flash
• gemini-2.0-flash-exp → gemini-2.0-flash
• gemini-1.5-pro → gemini-2.5-flash
• gemini-1.5-pro-latest → gemini-2.5-flash

📦 Installation

pip install --upgrade elimu-research-assistant

🙏 Acknowledgments

This release is based on the excellent work in web_research_agent, adapted specifically for educational use in Kenya.

Release v1.0.4

Full Changelog: v1.0.3...v1.0.4

Release v1.0.3

Added

• Dynamic versioning system using VERSION file as single source of truth
• Enhanced MANIFEST.in to include all necessary package files
• Improved version bump script with changelog integration

Changed

• Migrated from hardcoded versions to dynamic VERSION file system
• Updated setup.py to read version from VERSION file
• Enhanced init.py to dynamically load version
• Improved package structure for better maintainability

Fixed

• Resolved version synchronization issues across all components
• Fixed flake8 compliance in config.py global variable usage
• Eliminated hardcoded version references in CLI and setup files
• Improved GitHub Actions workflow compatibility

Release v1.0.2

🔧 Bug Fixes

• Fixed configuration management and global variable usage
• Improved package structure for PyPI distribution
• Enhanced version synchronization across components

📚 Features

• Intelligent research assistant for Kenyan educators
• ReAct framework for research synthesis
• Localized educational content generation

📦 Installation

pip install elimu-research-assistant
elimu --help

Release v1.0.2

🔧 Bug Fixes

• Fixed configuration management and global variable usage
• Improved package structure for PyPI distribution
• Enhanced version synchronization across components

📚 Features

• Intelligent research assistant for Kenyan educators
• ReAct framework for research synthesis
• Localized educational content generation

📦 Installation

pip install elimu-research-assistant
elimu --help

Release v1.0.1

Bug fixes and improvements