{"id":42752042,"url":"https://github.com/integeralex/advance-image-viewer","last_synced_at":"2026-01-29T20:00:19.089Z","repository":{"id":324267800,"uuid":"1095966892","full_name":"IntegerAlex/advance-image-viewer","owner":"IntegerAlex","description":null,"archived":false,"fork":false,"pushed_at":"2025-11-17T19:36:00.000Z","size":3560,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-11-17T20:29:40.461Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IntegerAlex.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT","agents":null,"dco":null,"cla":null}},"created_at":"2025-11-13T18:56:24.000Z","updated_at":"2025-11-17T19:36:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/IntegerAlex/advance-image-viewer","commit_stats":null,"previous_names":["integeralex/imager-viewer","integeralex/advance-image-viewer"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/IntegerAlex/advance-image-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntegerAlex%2Fadvance-image-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntegerAlex%2Fadvance-image-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntegerAlex%2Fadvance-image-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntegerAlex%2Fadvance-image-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IntegerAlex","download_url":"https://codeload.github.com/IntegerAlex/advance-image-viewer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntegerAlex%2Fadvance-image-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28883959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-29T19:55:09.949Z","status":"ssl_error","status_checked_at":"2026-01-29T19:55:08.490Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-29T20:00:16.366Z","updated_at":"2026-01-29T20:00:19.048Z","avatar_url":"https://github.com/IntegerAlex.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Advance Image Viewer\n\nA 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.\n\n![Application Interface](screenshots/application.png)\n\n*\"...where computational vision meets artificial intelligence\"* - A modern approach to digital image analysis and transformation.\n\n## Core Features\n\nAdvance Image Viewer combines traditional image viewing capabilities with cutting-edge AI technology:\n\n- **Advanced Visualization**: Cursor-centric zoom, high-performance rendering, and adaptive pan control\n- **AI-Powered Editing**: Direct integration with Google's Gemini models for intelligent image manipulation\n- **Developer Tools**: Comprehensive debugging interface and performance profiling\n\nFor detailed feature descriptions, see [FEATURES.md](FEATURES.md).\n\n## Technical Architecture\n\n### Core Implementation\n\nBuilt 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.\n\n### Command Line Interface\n\n```bash\npython main.py [\u003cimage_path\u003e] [--debug]\n```\n\n**Parameters:**\n\n- `\u003cimage_path\u003e`: (Optional) Path to target image file (supports all PIL-compatible formats). If not provided, the application starts with an empty interface.\n- `--debug`: Enables verbose debug logging\n\n### Human-Computer Interaction Protocol\n\n#### Primary Input Modalities\n\n- **Orbital Navigation**: Mouse wheel implements logarithmic zoom scaling centered on cursor coordinates using advanced transformation matrices\n- **Translational Manipulation**: Left mouse button enables viewport translation with momentum-based physics simulation\n- **Keyboard Accelerators**: Ctrl + / - provides discrete zoom levels with hysteresis compensation\n- **Menu Navigation**: File menu provides Open, Save As, and Exit options with keyboard shortcuts (Ctrl+O, Ctrl+S, Ctrl+Q)\n- **Termination Sequence**: Escape key triggers graceful application shutdown with resource cleanup\n\n#### AI-Enhanced Image Transformation Pipeline\n\n![AI-Generated Content](screenshots/ai-generated.png)\n\n**Operational Workflow:**\n\n1. **Authentication Configuration**: Secure API key provisioning via environment variables or direct input\n2. **Semantic Prompt Processing**: Natural language interpretation for precise transformation directives\n3. **Neural Network Inference**: Real-time interaction with Gemini multimodal models\n4. **Artifact Persistence**: High-fidelity image serialization to filesystem\n\n**Environment Variable Configuration:**\n\n```bash\n# Primary configuration\nexport GOSS_GEMINI_API_KEY=\"your-api-key-here\"\n\n# Fallback compatibility\nexport GEMINI_API_KEY=\"your-api-key-here\"\n```\n\n**Shell Integration (Bash/Zsh):**\n```bash\necho 'export GOSS_GEMINI_API_KEY=\"your-key\"' \u003e\u003e ~/.bashrc\nsource ~/.bashrc\n```\n\n**API Key Format Flexibility:**\n\n- **Raw Authentication**: Direct API key strings (`AIzaSy...`)\n- **URL Encapsulation**: Complete endpoint URLs with embedded credentials\n- **Query Parameter Extraction**: Isolated key-value pairs for modular configuration\n\n## System Prerequisites\n\n### Runtime Dependencies\n\n- **Python Ecosystem**: Version 3.8 or higher with comprehensive standard library support\n- **Image Processing Library**: PIL/Pillow for advanced bitmap manipulation and format support\n- **HTTP Client Library**: Requests for robust REST API communication with connection pooling and SSL verification\n- **GUI Framework**: Tkinter (bundled with Python) for cross-platform graphical user interface implementation\n\n## Deployment Strategies\n\n### Binary Distribution (Recommended)\n\n#### POSIX-Compatible Systems (Linux/macOS)\n\n**Cloudflare CDN Distribution:**\n```bash\ncurl -fsSL https://advance-image-viewer.gossorg.in | bash\n```\n\n**Manual Installation Protocol:**\n```bash\n# Ensure executable permissions\nchmod +x installer.sh\n\n# Execute deployment script\n./installer.sh\n```\n\n**Installation Vector Analysis:**\n\n- Automated binary retrieval from GitHub releases\n- Strategic placement in `~/.local/bin/` for user-level accessibility\n- PATH environment augmentation with conflict detection\n- Integrity verification through checksum validation\n\n#### Microsoft Windows Platform\n\n**Primary Installation Vector:**\n\n```powershell\nirm https://advance-image-viewer.gossorg.in | iex\n```\n\n**Execution Policy Configuration:**\n```powershell\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\nirm https://advance-image-viewer.gossorg.in | iex\n```\n\n**Fallback Distribution Channel:**\n```powershell\nSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser\nInvoke-WebRequest -Uri \"https://raw.githubusercontent.com/IntegerAlex/advance-image-viewer/master/installer.ps1\" -OutFile installer.ps1\n.\\installer.ps1\n```\n\n**Windows Deployment Characteristics:**\n- Binary artifact retrieval via GitHub API integration\n- Installation target: `%LOCALAPPDATA%\\Programs\\advance-image-viewer\\imageviewer.exe`\n- Automated PATH registry modification with administrative privilege detection\n\n## Technical Philosophy \u0026 Architectural Principles\n\n### Design Philosophy\nThis 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.\n\n\n## Additional Resources\n\n- **[FEATURES.md](FEATURES.md)**: Comprehensive feature documentation and technical specifications\n- **[CONTRIBUTING.md](CONTRIBUTING.md)**: Development guide for contributors and maintainers\n- **[CHANGELOG.md](CHANGELOG.md)**: Version history and release notes\n- **[LICENSE](LICENSE)**: GNU General Public License v3.0 terms and conditions\n- **[COPYRIGHT](COPYRIGHT)**: Copyright notices and licensing information\n\n---\n\n*\"In the convergence of human perception and machine intelligence lies the future of creative computation.\"*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintegeralex%2Fadvance-image-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintegeralex%2Fadvance-image-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintegeralex%2Fadvance-image-viewer/lists"}