Model types
The library organizes models into three main categories:Upscale models
Upscaling models increase image resolution while preserving or enhancing quality. These models can scale images by 2x, 3x, 4x, or higher factors depending on the specific model. Learn more about upscale modelsDescreen models
Descreening (also called dehalftoning) models remove halftone patterns and dot screens commonly found in printed comics and manga. These models operate at 1x scale and are typically applied before upscaling. Learn more about descreen modelsArtifact removal models
Artifact removal models clean up JPEG compression artifacts, blur, and other image degradation. These models are essential for restoring quality to compressed comic scans. Learn more about artifact removal modelsModel organization
Models are accessed through theOpenComicAI.models object, which is organized by type:
Automatic model downloading
Model files are not included with the package. Instead, they are downloaded automatically when first used:- Set models path: Configure where models should be stored
- Use a model: When you first reference a model in your pipeline
- Automatic download: The library downloads the required model files
- Local caching: Models are saved for future use
If you prefer to install all models upfront, use the
opencomic-ai-models package.Upscaler types
Models use one of three upscaler engines:realcugan
Advanced upscaling with noise reduction controls. Supports scales 2x, 3x, 4x with noise levels 0-3.
waifu2x
Flexible upscaling supporting 2x, 4x, 8x, 16x, 32x scales with noise levels 0-3.
upscayl
Fast, general-purpose upscaling. Most models support 2x, 3x, 4x scales. Used by most models in the library.
Model properties
Each model in the library includes the following properties:| Property | Description |
|---|---|
name | Human-readable model name |
upscaler | Engine type: realcugan, waifu2x, or upscayl |
scales | Array of supported scale factors |
noise | Noise reduction levels (or undefined if not supported) |
latency | Average processing time in seconds for a single image |
folder | Directory containing model files |
files | Array of model file names |
Performance considerations
Model performance varies significantly. The library includes latency data for each model to help you choose the right balance between speed and quality. View performance comparisonNext steps
Upscale models
Explore 30+ upscaling models
Descreen models
Remove halftone patterns
Artifact removal
Clean up compression artifacts
Performance
Compare model speeds