feat: SOTA AI photo colorization with DDColor deep learning model (#57) (#58)

Add AI-powered photo colorization that converts B&W/grayscale images to
full color using DDColor (ICCV 2023 dual-decoder architecture) via ONNX
Runtime. Includes model selection (Auto/DDColor/Classic), adjustable color
intensity, batch processing, before/after preview, and full HEIC/HEIF support.

Co-authored-by: stirling-image <stirling-image@users.noreply.github.com>
This commit is contained in:
stirling-image
2026-04-13 19:40:55 +08:00
committed by GitHub
co-authored by stirling-image
parent 58cdbe50b4
commit c280076098
12 changed files with 690 additions and 0 deletions
+183
View File
@@ -0,0 +1,183 @@
import { randomUUID } from "node:crypto";
import { writeFile } from "node:fs/promises";
import { basename, join } from "node:path";
import { colorize } from "@stirling-image/ai";
import type { FastifyInstance, FastifyReply, FastifyRequest } from "fastify";
import sharp from "sharp";
import { z } from "zod";
import { autoOrient } from "../../lib/auto-orient.js";
import { validateImageBuffer } from "../../lib/file-validation.js";
import { decodeHeic } from "../../lib/heic-converter.js";
import { resolveOutputFormat } from "../../lib/output-format.js";
import { createWorkspace } from "../../lib/workspace.js";
import { updateSingleFileProgress } from "../progress.js";
import { registerToolProcessFn } from "../tool-factory.js";
/**
* AI photo colorization route.
* Converts B&W / grayscale photos to full color using DDColor,
* with OpenCV DNN fallback.
*/
export function registerColorize(app: FastifyInstance) {
app.post("/api/v1/tools/colorize", async (request: FastifyRequest, reply: FastifyReply) => {
let fileBuffer: Buffer | null = null;
let filename = "image";
let settingsRaw: string | null = null;
let clientJobId: string | null = null;
try {
const parts = request.parts();
for await (const part of parts) {
if (part.type === "file") {
const chunks: Buffer[] = [];
for await (const chunk of part.file) {
chunks.push(chunk);
}
fileBuffer = Buffer.concat(chunks);
filename = basename(part.filename ?? "image");
} else if (part.fieldname === "settings") {
settingsRaw = part.value as string;
} else if (part.fieldname === "clientJobId") {
clientJobId = part.value as string;
}
}
} catch (err) {
return reply.status(400).send({
error: "Failed to parse multipart request",
details: err instanceof Error ? err.message : String(err),
});
}
if (!fileBuffer || fileBuffer.length === 0) {
return reply.status(400).send({ error: "No image file provided" });
}
const validation = await validateImageBuffer(fileBuffer);
if (!validation.valid) {
return reply.status(400).send({ error: `Invalid image: ${validation.reason}` });
}
try {
const settings = settingsRaw ? JSON.parse(settingsRaw) : {};
const intensity = Math.min(1, Math.max(0, Number(settings.intensity) || 1.0));
const model = settings.model || "auto";
request.log.info(
{ toolId: "colorize", imageSize: fileBuffer.length, intensity, model },
"Starting colorization",
);
// Decode HEIC/HEIF input
if (validation.format === "heif") {
fileBuffer = await decodeHeic(fileBuffer);
}
// Auto-orient to fix EXIF rotation
fileBuffer = await autoOrient(fileBuffer);
const jobId = randomUUID();
const workspacePath = await createWorkspace(jobId);
// Save input
const inputPath = join(workspacePath, "input", filename);
await writeFile(inputPath, fileBuffer);
// Progress callback
const jobIdForProgress = clientJobId;
const onProgress = jobIdForProgress
? (percent: number, stage: string) => {
updateSingleFileProgress({
jobId: jobIdForProgress,
phase: "processing",
stage,
percent,
});
}
: undefined;
// Process with Python sidecar
const result = await colorize(
fileBuffer,
join(workspacePath, "output"),
{ intensity, model },
onProgress,
);
// Resolve output format to match input
const outputFormat = await resolveOutputFormat(fileBuffer, filename);
let outputBuffer = result.buffer;
// Convert from PNG (Python output) to target format
if (outputFormat.format !== "png") {
outputBuffer = await sharp(result.buffer)
.toFormat(outputFormat.format, { quality: outputFormat.quality })
.toBuffer();
}
// Save output
const ext = outputFormat.format === "jpeg" ? "jpg" : outputFormat.format;
const outputFilename = `${filename.replace(/\.[^.]+$/, "")}_colorized.${ext}`;
const outputPath = join(workspacePath, "output", outputFilename);
await writeFile(outputPath, outputBuffer);
// Generate browser-compatible preview for non-previewable formats
const BROWSER_PREVIEWABLE = new Set(["png", "jpg", "jpeg", "webp", "gif", "avif", "bmp"]);
let previewUrl: string | undefined;
if (!BROWSER_PREVIEWABLE.has(ext)) {
try {
const previewBuffer = await sharp(outputBuffer).webp({ quality: 80 }).toBuffer();
const previewPath = join(workspacePath, "output", "preview.webp");
await writeFile(previewPath, previewBuffer);
previewUrl = `/api/v1/download/${jobId}/preview.webp`;
} catch {
// Non-fatal
}
}
if (clientJobId) {
updateSingleFileProgress({
jobId: clientJobId,
phase: "complete",
percent: 100,
});
}
return reply.send({
jobId,
downloadUrl: `/api/v1/download/${jobId}/${encodeURIComponent(outputFilename)}`,
previewUrl,
originalSize: fileBuffer.length,
processedSize: outputBuffer.length,
width: result.width,
height: result.height,
method: result.method,
});
} catch (err) {
request.log.error({ err, toolId: "colorize" }, "Colorization failed");
return reply.status(422).send({
error: "Colorization failed",
details: err instanceof Error ? err.message : "Unknown error",
});
}
});
// Register in the pipeline/batch registry
registerToolProcessFn({
toolId: "colorize",
settingsSchema: z.object({
intensity: z.number().min(0).max(1).default(1.0),
model: z.enum(["auto", "ddcolor", "opencv"]).default("auto"),
}),
process: async (inputBuffer, settings, filename) => {
const orientedBuffer = await autoOrient(inputBuffer);
const jobId = randomUUID();
const workspacePath = await createWorkspace(jobId);
const result = await colorize(orientedBuffer, join(workspacePath, "output"), {
intensity: (settings as { intensity?: number }).intensity ?? 1.0,
model: (settings as { model?: string }).model ?? "auto",
});
const outputFilename = `${filename.replace(/\.[^.]+$/, "")}_colorized.png`;
return { buffer: result.buffer, filename: outputFilename, contentType: "image/png" };
},
});
}
+2
View File
@@ -9,6 +9,7 @@ import { registerBulkRename } from "./bulk-rename.js";
import { registerCollage } from "./collage.js";
import { registerColorAdjustments } from "./color-adjustments.js";
import { registerColorPalette } from "./color-palette.js";
import { registerColorize } from "./colorize.js";
import { registerCompare } from "./compare.js";
import { registerCompose } from "./compose.js";
import { registerCompress } from "./compress.js";
@@ -130,6 +131,7 @@ export async function registerToolRoutes(app: FastifyInstance): Promise<void> {
{ id: "smart-crop", register: registerSmartCrop },
{ id: "image-enhancement", register: registerImageEnhancement },
{ id: "content-aware-resize", register: registerContentAwareResize },
{ id: "colorize", register: registerColorize },
];
let skipped = 0;
@@ -0,0 +1,154 @@
import { Download } from "lucide-react";
import { useState } from "react";
import { ProgressCard } from "@/components/common/progress-card";
import { useToolProcessor } from "@/hooks/use-tool-processor";
import { useFileStore } from "@/stores/file-store";
type Model = "auto" | "ddcolor" | "opencv";
const MODEL_OPTIONS: { value: Model; label: string; desc: string }[] = [
{ value: "auto", label: "Auto", desc: "Best available" },
{ value: "ddcolor", label: "DDColor", desc: "SOTA deep learning" },
{ value: "opencv", label: "Classic", desc: "Fast, lightweight" },
];
export function ColorizeSettings() {
const { files } = useFileStore();
const {
processFiles,
processAllFiles,
processing,
error,
downloadUrl,
originalSize,
processedSize,
progress,
} = useToolProcessor("colorize");
const [model, setModel] = useState<Model>("auto");
const [intensity, setIntensity] = useState(100);
const hasFile = files.length > 0;
const hasMultiple = files.length > 1;
const handleProcess = () => {
const settings = {
model,
intensity: intensity / 100,
};
if (hasMultiple) {
processAllFiles(files, settings);
} else {
processFiles(files, settings);
}
};
const handleSubmit = (e: React.FormEvent) => {
e.preventDefault();
if (hasFile && !processing) handleProcess();
};
return (
<form onSubmit={handleSubmit} className="space-y-3">
{/* Model selector */}
<SectionLabel>AI Model</SectionLabel>
<div className="grid grid-cols-3 gap-1">
{MODEL_OPTIONS.map((opt) => (
<button
type="button"
key={opt.value}
onClick={() => setModel(opt.value)}
className={`text-xs py-2 rounded transition-colors ${
model === opt.value
? "bg-primary text-primary-foreground"
: "bg-muted text-muted-foreground hover:bg-primary/10"
}`}
>
<span className="block font-medium">{opt.label}</span>
<span className="block text-[10px] opacity-70">{opt.desc}</span>
</button>
))}
</div>
{/* Color intensity */}
<SectionLabel>Color Intensity</SectionLabel>
<div>
<div className="flex justify-between items-center">
<span className="text-xs text-muted-foreground">
{intensity === 0
? "Grayscale"
: intensity < 50
? "Subtle"
: intensity < 80
? "Natural"
: "Vivid"}
</span>
<span className="text-xs font-mono text-foreground tabular-nums w-10 text-right">
{intensity}%
</span>
</div>
<input
type="range"
min={10}
max={100}
step={5}
value={intensity}
onChange={(e) => setIntensity(Number(e.target.value))}
className="w-full mt-0.5"
/>
<p className="text-[10px] text-muted-foreground/60 mt-0.5">
Lower values produce more muted, vintage-style colors.
</p>
</div>
{error && <p className="text-xs text-red-500">{error}</p>}
{originalSize != null && processedSize != null && (
<div className="text-xs text-muted-foreground space-y-0.5">
<p>Original: {(originalSize / 1024).toFixed(1)} KB</p>
<p>Colorized: {(processedSize / 1024).toFixed(1)} KB</p>
</div>
)}
{processing ? (
<ProgressCard
active={processing}
phase={progress.phase === "idle" ? "uploading" : progress.phase}
label={hasMultiple ? `Colorizing ${files.length} images` : "Colorizing"}
stage={progress.stage}
percent={progress.percent}
elapsed={progress.elapsed}
/>
) : (
<button
type="submit"
data-testid="colorize-submit"
disabled={!hasFile || processing}
className="w-full py-2.5 rounded-lg bg-primary text-primary-foreground font-medium disabled:opacity-50 disabled:cursor-not-allowed flex items-center justify-center gap-2"
>
{hasMultiple ? `Colorize (${files.length} files)` : "Colorize"}
</button>
)}
{!hasMultiple && downloadUrl && (
<a
href={downloadUrl}
download
data-testid="colorize-download"
className="w-full py-2.5 rounded-lg border border-primary text-primary font-medium flex items-center justify-center gap-2 hover:bg-primary/5"
>
<Download className="h-4 w-4" />
Download
</a>
)}
</form>
);
}
function SectionLabel({ children }: { children: React.ReactNode }) {
return (
<p className="text-[11px] font-semibold uppercase tracking-wider text-muted-foreground/70 pt-1">
{children}
</p>
);
}
@@ -53,6 +53,10 @@ export function getSettingsSummary(toolId: string, settings: Record<string, unkn
if (settings.scale) return `${settings.scale}x`;
return "";
}
case "colorize": {
const pct = settings.intensity != null ? Math.round(Number(settings.intensity) * 100) : 100;
return `${pct}% intensity`;
}
default:
return "";
}
+1
View File
@@ -14,6 +14,7 @@ const TOOL_SUGGESTIONS: Record<string, string[]> = {
"watermark-text": ["compress", "convert"],
"watermark-image": ["compress", "convert"],
"text-overlay": ["compress", "convert"],
colorize: ["adjust-colors", "image-enhancement", "upscale", "compress"],
sharpening: ["adjust-colors", "compress", "convert", "resize"],
border: ["compress", "convert", "resize"],
};
+6
View File
@@ -244,6 +244,11 @@ const ImageEnhancementSettings = lazy(() =>
default: m.ImageEnhancementSettings,
})),
);
const ColorizeSettings = lazy(() =>
import("@/components/tools/colorize-settings").then((m) => ({
default: m.ColorizeSettings,
})),
);
// ── Color tool wrapper ─────────────────────────────────────────────
// Color tools share a single component but differ by toolId.
@@ -372,6 +377,7 @@ export const toolRegistry = new Map<string, ToolRegistryEntry>([
Settings: ImageEnhancementSettings as never,
},
],
["colorize", { displayMode: "before-after", Settings: ColorizeSettings }],
]);
export function getToolRegistryEntry(toolId: string): ToolRegistryEntry | undefined {
+49
View File
@@ -32,6 +32,14 @@ GFPGAN_MODEL_URL = (
GFPGAN_MODEL_PATH = os.path.join(GFPGAN_MODEL_DIR, "GFPGANv1.3.pth")
GFPGAN_MIN_SIZE = 300_000_000 # ~332 MB
DDCOLOR_MODEL_DIR = "/opt/models/ddcolor"
DDCOLOR_MODEL_URL = (
"https://huggingface.co/piddnad/DDColor-models/resolve/main/ddcolor_paper_tiny.pth"
)
DDCOLOR_ONNX_PATH = os.path.join(DDCOLOR_MODEL_DIR, "ddcolor.onnx")
DDCOLOR_MIN_SIZE = 50_000_000 # ~220 MB ONNX
REMBG_MODELS = [
"u2net",
"isnet-general-use",
@@ -145,6 +153,37 @@ def download_gfpgan_model():
print(f" GFPGANv1.3.pth downloaded ({size / 1_000_000:.1f} MB)\n")
def download_ddcolor_model():
"""Download pre-exported DDColor ONNX model for AI photo colorization.
Uses the pre-converted ONNX model from HuggingFace (facefusion repo)
for direct inference via onnxruntime without needing PyTorch.
"""
print("=== Downloading DDColor ONNX model ===")
os.makedirs(DDCOLOR_MODEL_DIR, exist_ok=True)
from huggingface_hub import hf_hub_download
print(" Downloading DDColor ONNX from HuggingFace...")
downloaded_path = hf_hub_download(
repo_id="facefusion/models-3.0.0",
filename="ddcolor.onnx",
local_dir=DDCOLOR_MODEL_DIR,
)
# huggingface_hub downloads to local_dir/filename
actual_path = os.path.join(DDCOLOR_MODEL_DIR, "ddcolor.onnx")
if not os.path.exists(actual_path) and os.path.exists(downloaded_path):
os.rename(downloaded_path, actual_path)
size = os.path.getsize(actual_path)
assert size > DDCOLOR_MIN_SIZE, (
f"DDColor model too small: {size} bytes (expected > {DDCOLOR_MIN_SIZE})"
)
print(f" DDColor ONNX model ready ({size / 1_000_000:.1f} MB)\n")
def download_paddleocr_models():
"""Pre-download PaddleOCR PP-OCRv5 model weights from HuggingFace.
@@ -242,6 +281,15 @@ def smoke_test():
)
print(" GFPGAN model file verified")
# DDColor ONNX model must exist
assert os.path.exists(DDCOLOR_ONNX_PATH), (
f"DDColor model missing: {DDCOLOR_ONNX_PATH}"
)
assert os.path.getsize(DDCOLOR_ONNX_PATH) > DDCOLOR_MIN_SIZE, (
"DDColor model file is too small"
)
print(" DDColor ONNX model file verified")
# PaddleOCR model directories must exist
for repo_id in PADDLEOCR_MODELS:
model_name = repo_id.split("/", 1)[1]
@@ -264,6 +312,7 @@ def main():
download_rembg_models()
download_realesrgan_model()
download_gfpgan_model()
download_ddcolor_model()
download_paddleocr_models()
download_paddleocr_vl_model()
verify_mediapipe()
+231
View File
@@ -0,0 +1,231 @@
"""AI photo colorization using DDColor ONNX model.
Converts grayscale / black-and-white photos to full color using the DDColor
dual-decoder architecture. Falls back to a lightweight OpenCV DNN colorizer
when the DDColor model is unavailable.
"""
import sys
import json
import os
import numpy as np
import cv2
from PIL import Image
def emit_progress(percent, stage):
"""Emit structured progress to stderr for bridge.ts to capture."""
print(json.dumps({"progress": percent, "stage": stage}), file=sys.stderr, flush=True)
DDCOLOR_MODEL_PATH = os.environ.get(
"DDCOLOR_MODEL_PATH",
"/opt/models/ddcolor/ddcolor.onnx",
)
# OpenCV DNN fallback model paths (lightweight ~17 MB)
OPENCV_PROTO_PATH = os.environ.get(
"OPENCV_COLORIZE_PROTO",
"/opt/models/colorize-opencv/colorization_deploy_v2.prototxt",
)
OPENCV_MODEL_PATH = os.environ.get(
"OPENCV_COLORIZE_MODEL",
"/opt/models/colorize-opencv/colorization_release_v2.caffemodel",
)
OPENCV_POINTS_PATH = os.environ.get(
"OPENCV_COLORIZE_POINTS",
"/opt/models/colorize-opencv/pts_in_hull.npy",
)
def colorize_ddcolor(img_bgr, intensity):
"""Colorize using DDColor ONNX model."""
import onnxruntime as ort
emit_progress(15, "Loading DDColor model")
providers = ["CUDAExecutionProvider", "CPUExecutionProvider"]
try:
from gpu import gpu_available
if not gpu_available():
providers = ["CPUExecutionProvider"]
except ImportError:
providers = ["CPUExecutionProvider"]
session = ort.InferenceSession(DDCOLOR_MODEL_PATH, providers=providers)
input_name = session.get_inputs()[0].name
input_shape = session.get_inputs()[0].shape
# Dynamic dims are strings ('w', 'h'), so default to 512 if not int
model_size = input_shape[2] if len(input_shape) == 4 and isinstance(input_shape[2], int) else 512
emit_progress(25, "Preprocessing image")
orig_h, orig_w = img_bgr.shape[:2]
# Convert to Lab, extract L channel
img_lab = cv2.cvtColor(img_bgr, cv2.COLOR_BGR2LAB)
orig_l = img_lab[:, :, 0].astype(np.float32)
# Prepare input: resize, normalize to [0, 1], NCHW format
img_resized = cv2.resize(img_bgr, (model_size, model_size))
img_float = img_resized.astype(np.float32) / 255.0
img_nchw = np.transpose(img_float, (2, 0, 1))
img_nchw = np.expand_dims(img_nchw, axis=0)
emit_progress(40, "Running AI colorization")
# Run inference - model outputs predicted ab channels
output = session.run(None, {input_name: img_nchw})[0]
emit_progress(75, "Post-processing colors")
# Output shape: (1, 2, H, W) - predicted ab channels
ab_pred = output[0] # (2, model_size, model_size)
# Resize ab channels back to original dimensions
ab_resized = np.zeros((2, orig_h, orig_w), dtype=np.float32)
for i in range(2):
ab_resized[i] = cv2.resize(ab_pred[i], (orig_w, orig_h))
# Model outputs ab values already in Lab scale (roughly -50 to +70)
ab_a = np.clip(ab_resized[0], -128, 127)
ab_b = np.clip(ab_resized[1], -128, 127)
# Apply intensity blending
if intensity < 1.0:
# Blend with original ab channels (grayscale has ab near 0)
orig_a = img_lab[:, :, 1].astype(np.float32) - 128.0
orig_b = img_lab[:, :, 2].astype(np.float32) - 128.0
ab_a = orig_a * (1 - intensity) + ab_a * intensity
ab_b = orig_b * (1 - intensity) + ab_b * intensity
# Reconstruct Lab image
result_lab = np.zeros((orig_h, orig_w, 3), dtype=np.uint8)
result_lab[:, :, 0] = np.clip(orig_l, 0, 255).astype(np.uint8)
result_lab[:, :, 1] = np.clip(ab_a + 128.0, 0, 255).astype(np.uint8)
result_lab[:, :, 2] = np.clip(ab_b + 128.0, 0, 255).astype(np.uint8)
# Convert back to BGR
result_bgr = cv2.cvtColor(result_lab, cv2.COLOR_LAB2BGR)
return result_bgr, "ddcolor"
def colorize_opencv(img_bgr, intensity):
"""Fallback colorization using lightweight OpenCV DNN model (Zhang et al.)."""
emit_progress(15, "Loading OpenCV colorizer")
net = cv2.dnn.readNetFromCaffe(OPENCV_PROTO_PATH, OPENCV_MODEL_PATH)
pts = np.load(OPENCV_POINTS_PATH).transpose().reshape(2, 313, 1, 1)
# Set cluster centers as 1x1 convolution kernel
net.getLayer(net.getLayerId("class8_ab")).blobs = [pts.astype(np.float32)]
net.getLayer(net.getLayerId("conv8_313_rh")).blobs = [
np.full([1, 313], 2.606, dtype=np.float32)
]
emit_progress(25, "Preprocessing image")
orig_h, orig_w = img_bgr.shape[:2]
# Convert to Lab
img_lab = cv2.cvtColor(img_bgr, cv2.COLOR_BGR2LAB)
orig_l = img_lab[:, :, 0].astype(np.float32)
# Resize L channel and normalize for the network
l_resized = cv2.resize(orig_l, (224, 224))
l_resized -= 50 # Mean subtraction
emit_progress(40, "Running colorization")
net.setInput(cv2.dnn.blobFromImage(l_resized))
ab_out = net.forward()[0] # (2, 56, 56)
emit_progress(75, "Post-processing colors")
# Resize ab to original size
ab_a = cv2.resize(ab_out[0], (orig_w, orig_h))
ab_b = cv2.resize(ab_out[1], (orig_w, orig_h))
# Apply intensity
if intensity < 1.0:
orig_a = img_lab[:, :, 1].astype(np.float32) - 128.0
orig_b = img_lab[:, :, 2].astype(np.float32) - 128.0
ab_a = orig_a * (1 - intensity) + ab_a * intensity
ab_b = orig_b * (1 - intensity) + ab_b * intensity
# Reconstruct
result_lab = np.zeros((orig_h, orig_w, 3), dtype=np.uint8)
result_lab[:, :, 0] = np.clip(orig_l, 0, 255).astype(np.uint8)
result_lab[:, :, 1] = np.clip(ab_a + 128.0, 0, 255).astype(np.uint8)
result_lab[:, :, 2] = np.clip(ab_b + 128.0, 0, 255).astype(np.uint8)
result_bgr = cv2.cvtColor(result_lab, cv2.COLOR_LAB2BGR)
return result_bgr, "opencv"
def main():
input_path = sys.argv[1]
output_path = sys.argv[2]
settings = json.loads(sys.argv[3]) if len(sys.argv) > 3 else {}
intensity = float(settings.get("intensity", 1.0))
model_choice = settings.get("model", "auto")
try:
emit_progress(5, "Opening image")
img_bgr = cv2.imread(input_path, cv2.IMREAD_COLOR)
if img_bgr is None:
# Try with Pillow for formats OpenCV can't read
pil_img = Image.open(input_path).convert("RGB")
img_bgr = cv2.cvtColor(np.array(pil_img), cv2.COLOR_RGB2BGR)
orig_h, orig_w = img_bgr.shape[:2]
result_bgr = None
method = "unknown"
# Try DDColor first
if model_choice in ("auto", "ddcolor"):
try:
if os.path.exists(DDCOLOR_MODEL_PATH):
result_bgr, method = colorize_ddcolor(img_bgr, intensity)
elif model_choice == "ddcolor":
emit_progress(10, "DDColor model not found, using fallback")
except Exception as e:
if model_choice == "ddcolor":
emit_progress(10, f"DDColor failed: {str(e)[:50]}")
result_bgr = None
# Try OpenCV fallback
if result_bgr is None and model_choice in ("auto", "opencv"):
try:
if os.path.exists(OPENCV_PROTO_PATH) and os.path.exists(OPENCV_MODEL_PATH):
result_bgr, method = colorize_opencv(img_bgr, intensity)
except Exception:
result_bgr = None
if result_bgr is None:
print(json.dumps({
"success": False,
"error": "No colorization model available. Install DDColor or OpenCV models.",
}))
sys.exit(1)
emit_progress(90, "Saving result")
# Save output as PNG (API route handles format conversion)
cv2.imwrite(output_path, result_bgr)
print(json.dumps({
"success": True,
"width": orig_w,
"height": orig_h,
"method": method,
"output_path": output_path,
}))
except Exception as e:
print(json.dumps({"success": False, "error": str(e)}))
sys.exit(1)
if __name__ == "__main__":
main()
+46
View File
@@ -0,0 +1,46 @@
import { readFile, writeFile } from "node:fs/promises";
import { join } from "node:path";
import { type ProgressCallback, runPythonWithProgress } from "./bridge.js";
export interface ColorizeOptions {
intensity?: number;
model?: string;
}
export interface ColorizeResult {
buffer: Buffer;
width: number;
height: number;
method: string;
}
export async function colorize(
inputBuffer: Buffer,
outputDir: string,
options: ColorizeOptions = {},
onProgress?: ProgressCallback,
): Promise<ColorizeResult> {
const inputPath = join(outputDir, "input_colorize.png");
const outputPath = join(outputDir, "output_colorize.png");
await writeFile(inputPath, inputBuffer);
const { stdout } = await runPythonWithProgress(
"colorize.py",
[inputPath, outputPath, JSON.stringify(options)],
{ onProgress },
);
const result = JSON.parse(stdout);
if (!result.success) {
throw new Error(result.error || "Colorization failed");
}
const actualOutputPath = result.output_path || outputPath;
const buffer = await readFile(actualOutputPath);
return {
buffer,
width: result.width,
height: result.height,
method: result.method ?? "unknown",
};
}
+1
View File
@@ -1,5 +1,6 @@
export { removeBackground } from "./background-removal.js";
export { isGpuAvailable, shutdownDispatcher } from "./bridge.js";
export { colorize } from "./colorization.js";
export type { DetectFacesResult, FaceRegion } from "./face-detection.js";
export { blurFaces, detectFaces } from "./face-detection.js";
export { inpaint } from "./inpainting.js";
+9
View File
@@ -177,6 +177,14 @@ export const TOOLS: Tool[] = [
icon: "Sparkles",
route: "/image-enhancement",
},
{
id: "colorize",
name: "AI Colorization",
description: "Convert B&W photos to full color with AI",
category: "ai",
icon: "Palette",
route: "/colorize",
},
// Watermark & Overlay
{
id: "watermark-text",
@@ -396,4 +404,5 @@ export const PYTHON_SIDECAR_TOOLS = [
"blur-faces",
"erase-object",
"ocr",
"colorize",
] as const;
+4
View File
@@ -84,6 +84,10 @@ export const en = {
name: "Content-Aware Resize",
description: "Intelligently resize images while preserving important content",
},
colorize: {
name: "AI Colorization",
description: "Convert black & white photos to full color using AI deep learning models",
},
"watermark-text": { name: "Text Watermark", description: "Add text watermark overlay" },
"watermark-image": { name: "Image Watermark", description: "Overlay a logo as watermark" },
"text-overlay": { name: "Text Overlay", description: "Add styled text to images" },