FILE // AI9-MANGA-COLORIZER GPU PIPELINE // WINDOWS

Project 02 // GPU Pipeline

AI9
Manga Colorizer

Hardware-aware local manga colorization built around real GPU inference, automated installation, automatic CUDA/PyTorch runtime selection, and local-only processing. No cloud API in the loop: the GPU doing the work is yours.

Demo

AI9 is the manga colorizer

Real local inference. Black-and-white manga in, colorized page out. This GIF is a real capture of AI9 taking a B&W page through the local GPU colorization workflow.

AI9 Manga Colorizer demo: a black-and-white manga page running through local GPU colorization to the finished colored result.
AI9 Manga Colorizer // B&W in → color out // LOCAL GPU // SELF-HOSTED

The Real Thing

Not a mockup

The demo above, the extension popup, and the live backend check were captured from this project's own repository and its actually-running install, not staged or drawn.

AI9 Firefox extension popup, showing the real color adjustment sliders, presets, and API URL field, rendered directly from the committed popup.html and popup.css.
extension/popup.html, rendered as shipped

● Live backend check, this machine, just now

$ curl -sk https://127.0.0.1:5000/ Manga Colorizer is Up and Running!

This is the same install this page tells you how to run: a real Flask backend, a real GPU behind it, and the real Windows background task (MangaColorizerAI9) keeping it alive between crashes and reboots.

In the Otaconskeep Story

The GPU/compute side of the Keep

OTACONSKEEP │ ├── OTACON: agents · memory · identity · │ │ orchestration · capabilities │ │ │ └── VOICE TRAINER: GPU Piper cloning │ (Genome · custom agent voices) │ └── AI9 MANGA COLORIZER: local GPU manga colorization · Firefox extension

Otacon is the agent platform. Genome Voice Trainer clones Piper voices for those agents on your GPU. AI9 is the manga colorizer — proof of the same discipline on a standalone GPU pipeline: detect real hardware, select the exact runtime, fail loudly when something's wrong, never a silent cloud fallback. See the demo GIF above for B&W → color on a real local install.

Architecture

Extension → backend → GPU pipeline

Firefox (contentScript.js) Flask backend (app-stream.py) Denoise (FFDNet) Colorize (GAN) Optional 4x upscale Content-hash cache

Concurrency is 1 by default: one page colorizes at a time, queued, so the GPU stays available for other work. A two-tier cache keyed by image content hash and processing options means switching color presets on an already-read page reuses the raw GPU output instead of a full re-run.

Hardware Support

Automatic GPU detection & runtime selection

The installer reads your GPU name and driver's max CUDA version directly from nvidia-smi, then picks the matching PyTorch wheel. No manual CUDA version guessing.

GPU generationCompute capabilityPyTorch build
RTX 50-series (Blackwell)sm_120cu128
RTX 40-series (Ada)sm_89cu121 / cu126
RTX 30-series (Ampere)sm_86cu118

Verified with a real GPU inference pass (matmul + cuDNN convolution kernels), not just torch.cuda.is_available(). That call can return True while still lacking compiled kernels for your specific architecture.

Install

Windows 10/11: double-click, not curl

AI9's installer targets Git Bash on Windows and refuses to run under WSL. It is not a Linux-style curl | bash one-liner. Here's the real supported path.

No WSL, no Linux VM, nothing to install ahead of time. If Git Bash isn't already on your machine, install_ai9.bat installs it for you automatically.

  1. Download the repo

    GitHub's green Code button → Download ZIP (then extract it), or git clone it.

  2. Double-click install_ai9.bat

    install_ai9.bat

    It finds or installs Git Bash automatically, then runs the real installer, install_ai9.sh, inside it.

  3. Or, if you already use Git Bash

    Open Git Bash in the extracted folder and run:

    ./install_ai9.sh
  4. Wait for it to finish

    Installs Python 3.12, Git, and Firefox if missing (via winget); detects your GPU and installs the matching PyTorch build; downloads and verifies the AI model weights; runs a real GPU inference test; registers a Windows background task so the server auto-starts and restarts itself on crash.

  5. Load the Firefox extension (the one manual step)

    Firefox requires a human click for unsigned add-ons. No installer can do this part. Go to about:debugging#/runtime/this-firefoxLoad Temporary Add-on → select extension/manifest.json from the install folder. This needs repeating after every full Firefox restart.

winget may trigger a Windows UAC prompt when installing missing Git, Python, or Firefox. The installer itself does not need to run elevated/as administrator.
Runs at https://127.0.0.1:5000/ (self-signed certificate, one-time browser warning is expected) and on your LAN at https://<your-lan-ip>:5000/.
Optional environment variables
VariableDefaultWhat it changes
AI9_INSTALL_DIRC:\opt\manga-colorizerWhere AI9 gets installed
AI9_INSTALL_FIREFOX1Set to 0 to skip installing Firefox
AI9_REGISTER_TASK1Set to 0 to skip auto-registering the background service

Full install documentation on GitHub →

Status

What ships, and its known limits

Available now

Real GPU inference (denoise + colorize)

Available now

Automatic PyTorch/CUDA wheel selection

Available now

Content-hash + options caching

Available now

Restart-on-crash background service

Available now

Adjustable color controls & presets

Available now

Optional 4x AI upscaling

Available now (off by default)

Known limitations (from the repository's own troubleshooting notes):