Photo editor Telegram bot

This tool provides in-chat image editing via a Telegram bot, enabling users to perform common photo edits directly in Telegram without exporting files to separate apps. Target users include content creators, social media managers, marketers, journalists, and casual users who need fast adjustments on mobile. The bot ingests an image from the chat (or via inline query) and returns a processed image with the requested edits, ready for sharing or posting.
\n\nCore Logic & Features: The bot implements a modular edit pipeline: input validation, transformation steps, and output encoding. Core features include crop and resize with aspect-ratio controls, rotate and flip, brightness/contrast/saturation adjustments, sharpening and blurring, color filters (grayscale, sepia, solarize), and watermark overlay. Optional/advanced capabilities include per-image edit presets, batch processing in a single chat thread, support for multiple output formats (JPEG, PNG, WEBP), and preservation of basic metadata when feasible. Required features: reliable image ingestion from Telegram, parameter parsing, deterministic output, and error handling. Optional features: presets, aspect-ratio presets (1:1, 4:5, 16:9), and watermark customization.
\n\nInputs & Outputs: Inputs include image data, a set of edits (crop rectangle or aspect ratio, resize width/height or scale, rotation angle, flip boolean, brightness, contrast, saturation, sharpness, filter type, optional watermark text or image, output format, quality/ compression, and preserve metadata flag). Outputs include the edited image in the selected format and quality, optional lower-resolution preview, and a log of applied operations for traceability. Validation ensures numeric ranges for brightness (-100..100), rotation (-360..360), and size constraints.
\n\nAlgorithms & Calculations: The tool uses standard image processing primitives: affine transforms for crop/resize/rotate; color-space adjustments in sRGB; separable filters for blur/sharpness; compositing for watermark overlays. Edge cases: unsupported formats, missing image data, invalid parameter ranges, or requests exceeding size limits result in precise failure codes rather than generic errors. Throttling and queueing handle multiple concurrent edits.
\n\nIndustry/Region & Localization: Defaults align with common image standards (JPEG, PNG, WEBP); dimensions expressed in pixels; color spaces follow sRGB; no country-specific processing restrictions. Assumptions & Exclusions: Assumes user has rights to edit the provided image; excludes video editing, complex multi-layer compositions, and advanced retouching that require full desktop-grade tools; no offline processing.