A sophisticated, AI-enhanced image visualization and analysis application built with Python, featuring advanced cursor-based zoom mechanics and seamless integration with Google's Gemini multimodal models for intelligent image manipulation.
"...where computational vision meets artificial intelligence" - A modern approach to digital image analysis and transformation.
Advance Image Viewer combines traditional image viewing capabilities with cutting-edge AI technology:
- Advanced Visualization: Cursor-centric zoom, high-performance rendering, and adaptive pan control
- AI-Powered Editing: Direct integration with Google's Gemini models for intelligent image manipulation
- Developer Tools: Comprehensive debugging interface and performance profiling
For detailed feature descriptions, see FEATURES.md.
Built with Python 3.10+ utilizing the Tkinter GUI framework for cross-platform compatibility and PIL/Pillow for robust image processing operations. The application implements a modular event-driven architecture with separation of concerns between visualization, AI integration, and user interface components.
python main.py [<image_path>] [--debug]Parameters:
<image_path>: (Optional) Path to target image file (supports all PIL-compatible formats). If not provided, the application starts with an empty interface.--debug: Enables verbose debug logging
- Orbital Navigation: Mouse wheel implements logarithmic zoom scaling centered on cursor coordinates using advanced transformation matrices
- Translational Manipulation: Left mouse button enables viewport translation with momentum-based physics simulation
- Keyboard Accelerators: Ctrl + / - provides discrete zoom levels with hysteresis compensation
- Menu Navigation: File menu provides Open, Save As, and Exit options with keyboard shortcuts (Ctrl+O, Ctrl+S, Ctrl+Q)
- Termination Sequence: Escape key triggers graceful application shutdown with resource cleanup
Operational Workflow:
- Authentication Configuration: Secure API key provisioning via environment variables or direct input
- Semantic Prompt Processing: Natural language interpretation for precise transformation directives
- Neural Network Inference: Real-time interaction with Gemini multimodal models
- Artifact Persistence: High-fidelity image serialization to filesystem
Environment Variable Configuration:
# Primary configuration
export GOSS_GEMINI_API_KEY="your-api-key-here"
# Fallback compatibility
export GEMINI_API_KEY="your-api-key-here"Shell Integration (Bash/Zsh):
echo 'export GOSS_GEMINI_API_KEY="your-key"' >>
AD3C
; ~/.bashrc
source ~/.bashrcAPI Key Format Flexibility:
- Raw Authentication: Direct API key strings (
AIzaSy...) - URL Encapsulation: Complete endpoint URLs with embedded credentials
- Query Parameter Extraction: Isolated key-value pairs for modular configuration
- Python Ecosystem: Version 3.8 or higher with comprehensive standard library support
- Image Processing Library: PIL/Pillow for advanced bitmap manipulation and format support
- HTTP Client Library: Requests for robust REST API communication with connection pooling and SSL verification
- GUI Framework: Tkinter (bundled with Python) for cross-platform graphical user interface implementation
Cloudflare CDN Distribution:
curl -fsSL https://advance-image-viewer.gossorg.in | bashManual Installation Protocol:
# Ensure executable permissions
chmod +x installer.sh
# Execute deployment script
./installer.shInstallation Vector Analysis:
- Automated binary retrieval from GitHub releases
- Strategic placement in
~/.local/bin/for user-level accessibility - PATH environment augmentation with conflict detection
- Integrity verification through checksum validation
Primary Installation Vector:
irm https://advance-image-viewer.gossorg.in | iexExecution Policy Configuration:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm https://advance-image-viewer.gossorg.in | iexFallback Distribution Channel:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/IntegerAlex/advance-image-viewer/master/installer.ps1" -OutFile installer.ps1
.\installer.ps1Windows Deployment Characteristics:
- Binary artifact retrieval via GitHub API integration
- Installation target:
%LOCALAPPDATA%\Programs\advance-image-viewer\imageviewer.exe - Automated PATH registry modification with administrative privilege detection
This project embodies a synthesis of classical computer vision techniques with contemporary artificial intelligence paradigms. The application serves as a bridge between traditional image processing methodologies and the transformative potential of generative AI, creating an accessible interface for computational creativity.
- FEATURES.md: Comprehensive feature documentation and technical specifications
- CONTRIBUTING.md: Development guide for contributors and maintainers
- CHANGELOG.md: Version history and release notes
- LICENSE: GNU General Public License v3.0 terms and conditions
- COPYRIGHT: Copyright notices and licensing information
"In the convergence of human perception and machine intelligence lies the future of creative computation."