lexigram-multimedia-upscale

Image and video super-resolution for the Lexigram Framework — local reference-server backends (real-esrgan, hat).

Overview

lexigram-multimedia-upscale upscales images 2x or 4x with Real-ESRGAN or HAT reference servers, and registers a VideoUpscaleService for frame-level video upscaling when a VideoProcessor is available in the container.

Full documentation: docs.lexigram.dev

Install

uv add lexigram-multimedia-upscale
# Optional extras
uv add "lexigram-multimedia-upscale[real-esrgan-server]"  # Real-ESRGAN server deps
uv add "lexigram-multimedia-upscale[hat-server]"          # HAT server deps

Quick Start

from lexigram import Application
from lexigram.di.module import Module, module
from lexigram.multimedia.upscale import UpscaleModule
from lexigram.contracts.multimedia import UpscaleProvider, UpscaleRequest, MediaAsset


@module(imports=[UpscaleModule.configure()])
class AppModule(Module):
    pass


async def main() -> None:
    async with Application.boot(modules=[AppModule]) as app:
        upscale = await app.container.resolve(UpscaleProvider)
        asset = MediaAsset(mime_type="image/png", provider="local", bytes_data=b"<png>")
        result = await upscale.upscale(UpscaleRequest(asset=asset, scale_factor=4))
        if result.is_ok():
            upscaled = result.unwrap()  # MediaAsset — upscaled image bytes or URI


if __name__ == "__main__":
    import asyncio

    asyncio.run(main())

Configuration

Zero-config usage: Call UpscaleModule.configure() with no arguments to use the real-esrgan backend at http://localhost:5400.

Option 1 — YAML file

# application.yaml
multimedia:
  upscale:
    backend: "hat"

Option 2 — Profiles + Environment Variables

export LEX_PROFILE=production
export LEX_MULTIMEDIA__UPSCALE__BACKEND=real-esrgan

Option 3 — Python

from lexigram.multimedia.upscale import UpscaleModule
from lexigram.multimedia.upscale.config import UpscaleConfig

UpscaleModule.configure(config=UpscaleConfig(backend="hat"))

The upscale factor is a per-request parameter — UpscaleRequest(asset=..., scale_factor=Literal[2, 4]), default 4. It is not part of UpscaleConfig.

Config reference

Module Factory Methods

Key Features

• Two backends — real-esrgan, hat reference servers
• Video upscaling — VideoUpscaleService for frame-level video super-resolution (when VideoProcessor is available)
• Reference servers — lexigram-upscale-real-esrgan-serve and lexigram-upscale-hat-serve console scripts run each local model server
• Result-based — upscale() -> Result[MediaAsset, MultimediaError]; errors are domain values, not exceptions

Testing

from lexigram import Application
from lexigram.multimedia.upscale import UpscaleModule


async def test_boot():
    async with Application.boot(modules=[UpscaleModule.stub()]) as app:
        assert app.container is not None

Key Source Files