monipix 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2d07dc5a698802da7d2b29a0997d711a2331bcc1598aaebc85a8c281c0ad3091
+  data.tar.gz: e6a47166110028dabd4c5a4d7d29d5e0de16b99354667918c88e0bb430089f16
+SHA512:
+  metadata.gz: 4d4688dcecd1d21cdab3928266479294df32dd600e83ee72b00555eb4520689598f323635925ac88abc4833bae464729f763c627a53e0e3d4ceee5607e17856e
+  data.tar.gz: a068de8778ecf0d3c5a7d3156d8999c9a5584b64f51dad4350b50be4f3b81ef369574cd4749e8b3f416157b2f2b246669c0b4843ced43bcdcea9c7e243eea334

data/README.md

@@ -0,0 +1,86 @@
+# Monipix AI Image Upscaler & Super-Resolution Toolkit (4K / 8K / 16K)
+
+[![Website](https://img.shields.io/badge/Website-monipix.com-blue)](https://monipix.com)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Max Resolution](https://img.shields.io/badge/Output-4K%20%7C%208K%20%7C%2016K-purple)](https://monipix.com/tools/hd-image-converter)
+
+Open documentation, resolution planning reference, and local batch-preparation CLI (`prepare_for_upscale.py`) for **[Monipix](https://monipix.com)** — an AI creative workspace built around neural image super-resolution (2x, 4x, 8x, and 16x up to **16K**), prompt-guided photo cleanup, and AI image/video generation.
+
+---
+
+## Overview & Architecture
+
+Traditional bicubic or Lanczos resampling interpolates existing pixels mathematically, leaving edges soft and amplifying JPEG block artifacts when enlarging low-resolution images for print or high-DPI displays. **[Monipix](https://monipix.com)** combines two complementary super-resolution pipelines with a suite of prompt-based editing and generation tools:
+
+1. **Standard Super-Resolution (2x / 4x / 8x / 16x up to 16K):** Reconstructs sharp edges, fine surface textures, hair, fabric, and typography while stripping compression noise—preserving strict structural fidelity to the original photo.
+2. **Creative Upscale:** Allows fine-tuning **Creativity** and **Resemblance** sliders alongside an optional text prompt to hallucinate plausible micro-detail on severely degraded, low-pixel, or AI-generated drafts.
+
+### Core Web Tools & Endpoints
+
+| Tool | URL | Primary Capabilities |
+| :--- | :--- | :--- |
+| **AI Image Upscaler (Workspace)** | [https://monipix.com](https://monipix.com) | Batch upload up to 10 images (JPG, PNG, WEBP, HEIC up to 50 MB each); 2x/4x/8x/16x Standard & Creative Upscale up to 16K; side-by-side comparison slider; 10 free credits/month. |
+| **HD Image Converter** | [https://monipix.com/tools/hd-image-converter](https://monipix.com/tools/hd-image-converter) | Convert low-res pictures, product shots, anime art, and old scans into crisp 4K, 8K, or 16K PNG/JPG/WEBP exports. |
+| **AI Object Remover** | [https://monipix.com/tools/object-remover](https://monipix.com/tools/object-remover) | Remove unwanted people, tourists, wires, watermarks, or background clutter via natural-language prompts without manual brush masking. |
+| **Edit Text in Image** | [https://monipix.com/tools/text-editor](https://monipix.com/tools/text-editor) | Replace, translate, or fix signs, labels, and poster typography inside photos while preserving the original font, perspective, and lighting. |
+| **AI Image Generator** | [https://monipix.com/tools/ai-image-generator](https://monipix.com/tools/ai-image-generator) | Text-to-image and multi-reference image-to-image generation powered by Nano Banana 2, GPT Image 1.5, Seedream 5.0 Lite, and Flux Kontext. |
+| **AI Video Generator** | [https://monipix.com/tools/ai-video-generator](https://monipix.com/tools/ai-video-generator) | Animate upscaled still photos or text prompts into 1080p/4K video clips using Hailuo H3, Seedance 2.0, Kling 3.0, and Veo 3.1. |
+
+---
+
+## 2x / 4x / 8x / 16x Super-Resolution Comparison Table
+
+Choosing the right scale factor avoids unnecessary file bloat while meeting target print DPI or display density requirements:
+
+| Scale Factor | Typical Input Size | Output Resolution | Equivalent Target | Recommended Use Cases |
+| :---: | :---: | :---: | :---: | :--- |
+| **2x** | `1024 × 1024` | `2048 × 2048` (2K) | Web Retina / Social HD | E-commerce catalog thumbnails, social media posts, sharpening soft smartphone photos. |
+| **4x** | `1024 × 1024` | `4096 × 4096` (**4K**) | UHD Monitor / A3 Print @ 300 DPI | AI-generated mid-res art, YouTube 4K thumbnails, magazine spreads, framed photo prints. |
+| **8x** | `1024 × 1024` | `8192 × 8192` (**8K**) | 8K Display / A1 Poster @ 300 DPI | Archival family photo restoration, large-format exhibition posters, detailed texture crops. |
+| **16x** | `960 × 540` | `15360 × 8640` (**16K**) | Trade-Show Banner / Fine Art Mural | Extreme enlargement of legacy digital camera shots, small cropped regions, or billboard graphics. |
+
+---
+
+## Practical Production Workflows
+
+### Workflow 1: E-Commerce & Product Photography Cleanup -> 4K/8K Catalog Export
+1. **Clean up distractions:** Open the [AI Object Remover](https://monipix.com/tools/object-remover) and describe background dust, reflections, or props to erase cleanly.
+2. **Localize packaging copy (optional):** Use [Edit Text in Image](https://monipix.com/tools/text-editor) to update label text or pricing while keeping lighting intact.
+3. **Upscale to 4K/8K:** Batch-upload up to 10 cleaned product shots into the [HD Image Converter](https://monipix.com/tools/hd-image-converter) at **4x** (`4K`) for zoomable store pages.
+
+### Workflow 2: Concept Art -> 16K Print or Animated Keyframe
+1. **Generate base composition:** Create a draft concept in the [AI Image Generator](https://monipix.com/tools/ai-image-generator) using text-to-image or up to 5 reference images.
+2. **Super-resolution pass:** Run **4x–16x** upscaling on [Monipix](https://monipix.com) (using *Creative Upscale* if extra micro-texture is desired).
+3. **Animate to video:** Send the crisp keyframe to the [AI Video Generator](https://monipix.com/tools/ai-video-generator) to render a 5–10 second camera move or character animation.
+
+---
+
+## Local CLI Utility: `prepare_for_upscale.py`
+
+Before uploading a batch of images to [Monipix](https://monipix.com) (which accepts up to **10 files per batch**, **50 MB max per file**, in `JPG`, `PNG`, `WEBP`, or `HEIC`), use `prepare_for_upscale.py` to audit a local folder, calculate exact post-upscale pixel dimensions and print sizes at 300 DPI, recommend the optimal multiplier (`2x`, `4x`, `8x`, or `16x`) for your target resolution (`4k`, `8k`, or `16k`), and group files into ready-to-upload batches of 10.
+
+### Usage
+
+```bash
+# Audit a directory of images for 4K delivery and print a batch plan
+python3 prepare_for_upscale.py ./photos --target 4k
+
+# Audit for 16K large-format print and export a JSON manifest
+python3 prepare_for_upscale.py ./archive_scans --target 16k --json manifest.json
+```
+
+Zero external dependencies are required (the script parses PNG, JPEG, and WEBP headers directly using the Python standard library).
+
+---
+
+## Companion Guides & Related Repositories
+
+- **[AI Image Upscaling & Restoration Handbook](https://arkyu2077.github.io/image-upscaling-guide/)** — Vendor-neutral notes on 4K–16K super-resolution, KB resizing vs neural upscaling, and prompt-based photo cleanup.
+- **[Video Upscaling Handbook](https://arkyu2077.github.io/video-upscaling-guide/)** & **[ai-video-upscaler](https://github.com/arkyu2077/ai-video-upscaler)** — Temporal video super-resolution for 1080p, 2K, and 4K video clips.
+- **[Whiteboard & Speedpaint Video Handbook](https://arkyu2077.github.io/whiteboard-video-guide/)** & **[SpeedPainter Explainer Video](https://github.com/SpeedPainterOrg/explainer-video)** — Turn upscaled illustrations or text into hand-drawn speedpaint and narrated whiteboard videos.
+
+---
+
+## License
+
+Released under the [MIT License](LICENSE).

data/lib/monipix.rb

@@ -0,0 +1,5 @@
+# Official Ruby SDK for monipix (https://monipix.com)
+module Monipix
+  BASE_URL = 'https://monipix.com'
+  DOCS_URL = 'https://monipix.com/tools/hd-image-converter'
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: monipix
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ark Yu
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-11-04 00:00:00.000000000 Z
+dependencies: []
+description: Official SDK & CLI for Monipix (https://monipix.com) — AI Image Upscaler
+  to 4K, 8K & 16K, AI Photo Restoration, Object Removal & Creative Studio.
+email: arkyu.002@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/monipix.rb
+homepage: https://monipix.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://monipix.com
+  documentation_uri: https://monipix.com/tools/hd-image-converter
+  source_code_uri: https://github.com/arkyu2077/ai-image-upscaler
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Official SDK & CLI for Monipix (https://monipix.com) — AI Image Upscaler
+  to 4K, 8K & 16K, AI Photo Restoration, Object Removal & C
+test_files: []