discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
midcodehub/miaoCut · source
Snapshot 0 · 2026-11-04T12:47:28Z · HTML · MIT
Content fingerprint
d0a9da943239c46a9563f981259c5c013475cd26b842db3a5dfc606c60a5bb45GitHub description at capture
免费、注重隐私的在线 AI 图像处理工具箱（包含一键抠图、去水印、老照片修复等）。无水印，免注册。| A free, privacy-first online AI image toolkit featuring one-click background removal, watermark remover, and old photo restoration. No signup required. 🔗 https://miaocut.app
README at capture
--- title: miaoCut sdk: docker app_port: 7860 --- # MiaoCut — Free Online AI Background Remover <p align="center"> <a href="https://miaocut.app"><img src="https://miaocut.app/og/home.png" alt="MiaoCut — Free AI Background Remover" width="640"></a></p> <p align="center"> <a href="https://trendshift.io/repositories/10645" target="_blank"><img src="https://trendshift.io/api/badge/repositories/10645" alt="idootop%2Fmi-gpt | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </p> <p align="center"> <strong>👉 Try the <a href="https://miaocut.app">Free AI Background Remover</a> live (no signup)</strong> </p> <p align="center"> <a href="https://miaocut.app"><img src="https://img.shields.io/badge/Live-miaocut.app-2563eb" alt="Free AI Background Remover"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="MIT License"></a> <img src="https://img.shields.io/badge/Signup-Not%20required-brightgreen" alt="No signup"> <img src="https://img.shields.io/badge/Watermark-None-brightgreen" alt="No watermark"> </p> <p align="center"> <b>English</b> · <a href="README.zh-CN.md">简体中文</a> </p> **MiaoCut** is a **free, no-signup online AI image toolkit**. Its core feature is **one-click background removal** — upload any photo and an AI segmentation model (BiRefNet) erases the background in about a second and returns a transparent PNG. It also ships a small family of related tools: ID photo maker, watermark remover, old-photo restoration, and format converters. > 🔗 **Remove backgrounds online with [MiaoCut's free background remover](https://miaocut.app)** — no account, no credit card, no watermark. --- ## ✨ Why MiaoCut - 🚀 **Instant** — cutouts in ~1 second, no waiting room. - 🎨 **Full quality** — exports a transparent PNG at the original resolution, **no watermark**. - 🔒 **Privacy-first** — images are processed **in memory and discarded immediately**; nothing is stored, nothing is used to train AI. - 🆓 **Completely free** — no hidden fees, no subscription traps, no signup. - 🌍 **Works anywhere** — runs in any browser, on desktop or mobile. ## 🧰 Tools Every tool is available in [MiaoCut's free AI image toolkit](https://miaocut.app): | Tool | Link | What it does | |------|------|------| | **AI Background Remover** | [Free AI Background Remover](https://miaocut.app) | One-click background removal. Two modes: **Sharp** (fast, hard edges) and **Fur** (fine hair / fur / soft edges). | | **Product Photo Background Remover** | [/product-photo-background-remover/](https://miaocut.app/product-photo-background-remover/) | Clean white-background and square-canvas product shots for e-commerce. | | **Portrait Background Remover** | [/portrait-background-remover/](https://miaocut.app/portrait-background-remover/) | Headshots, profile pictures, and social media cutouts. | | **ID / Passport Photo Maker** | [/id-photo-maker/](https://miaocut.app/id-photo-maker/) | Auto cutout + background color swap + print layout for common ID photo specs. | | **Watermark Remover** | [/watermark-remover/](https://miaocut.app/watermark-remover/) | Brush over a watermark and let AI inpaint it away (LaMa). | | **Old Photo Restoration** | [/old-photo-restoration/](https://miaocut.app/old-photo-restoration/) | Repair fading, reduce noise, and enhance detail in old photos. | | **JPG → Transparent PNG** | [/jpg-to-transparent-png/](https://miaocut.app/jpg-to-transparent-png/) | Turn a JPG into a true transparent PNG with a real alpha channel. | | **PNG → JPG (white background)** | [/png-to-jpg-white-background/](https://miaocut.app/png-to-jpg-white-background/) | Flatten a transparent PNG onto white (or any color) and export as JPG. | 📚 **Guides:** step-by-step tutorials on [how to remove a background](https://miaocut.app/how-to-remove-background/) in PowerPoint, GIMP, and more. ## 🔬 How the cutout works The background-removal pipeline picks one of two profiles per request: - **`sharp`** (default, ~1s) — BiRefNet produces the mask, followed by gentle gamma correction and 1px anti-aliasing. Best for people, products, and logos with hard edges. - **`fur`** (~3–5s) — adds **alpha matting** (closed-form solve on the trimap's unknown band) plus foreground-color estimation to remove background-color contamination on semi-transparent pixels. Best for white cats, curly hair, feathers, and other soft edges. ## 🏗️ Architecture ``` ┌─────────────────────────────────┐ ┌────────────────────────────────────┐ │ Frontend (static) │ │ Backend (API) │ │ HTML + Tailwind CSS + vanilla │ ───▶ │ FastAPI + BiRefNet (rembg) │ │ JS, deployed on Cloudflare │ │ on Hugging Face Docker Spaces ×3 │ │ Pages │ │ (miao_cut / miao_cut2 / miao_cut3) │ └─────────────────────────────────┘ └────────────────────────────────────┘ ``` - **Frontend** — static HTML pages (`index.html` + compiled `output.css`) with EN/ZH/HI/ID/PT-BR/BN/FIL/UR i18n, client-side image compression, XHR upload with real progress. Served by Cloudflare Pages. - **Backend** — FastAPI (single worker). AI models: **BiRefNet-General-Lite** (INT8 quantized) via rembg for cutouts, **MediaPipe Face Mesh** for ID-photo cropping, **LaMa** inpainting for watermark removal. Rate limiting (SlowAPI) and concurrency control live in process memory — **no Redis or external state**. ## 🚀 Run it yourself **Requirements:** Python 3.11+ (backend), Node.js 18+ (frontend build only). ### Backend ```bash pip install -r requirements.txt # Start the dev server. ⚠️ Use `python main.py`, NOT `uvicorn main:app` # (the string form re-imports main.py and loads BiRefNet twice). python main.py # First run downloads the model weights to .u2net/. Serves on http://127.0.0.1:8000 ``` > Don't pass `--reload` (onnxruntime's thread pool deadlocks after fork) or `--workers 2+` (rate-limit and concurrency budgets live in process memory). ### Frontend ```bash npm install npm run build # builds output.css + generates localized pages + sitemap npm run watch:css # watch mode while editing HTML ``` > After changing any class in an HTML file, re-run `npm run build:css` and commit the updated `output.css` — production serves it as-is. ### Docker ```bash docker build -t miaocut-api . docker run --rm -p 7860:7860 -e PORT=7860 -e MAX_CONCURRENCY=1 -v miaocut-data:/data miaocut-api ``` ## ⚙️ Configuration (environment variables) | Variable | Default | Description | |----------|---------|-------------| | `PORT` | `8000` | Port to listen on | | `TRUST_PROXY` | `0` | Set `1` to read the real client IP from `X-Forwarded-For` | | `ALLOWED_ORIGINS` | empty (skips check) | Comma-separated allowed frontend origins | | `MAX_CONCURRENCY` | `1` | Max concurrent inferences (key knob against OOM) | | `CUTOUT_PROFILE` | `sharp` | Default cutout profile (`sharp` / `fur`) | | `DATA_DIR` | `.` | Directory for persisted feedback data | | `ENABLE_DOCS` | `1` | Set `0` to disable the `/docs` endpoint | ## 🛡️ Privacy & security - Images are processed **purely in memory** and destroyed immediately after. - **No** uploaded image is stored. - User data is **never** used to train AI models. - Origin verification + per-IP rate limiting guard against abuse. ## 🤝 Contributing Issues and pull requests are welcome. If MiaoCut is useful to you, a ⭐ on GitHub and a link back to the **[free AI background remover](https://miaocut.app)** are hugely appreciated — they help more people find a free, privacy-respecting background remover. ## 📄 License Released under the [MIT License](LICENSE). You're free to use, modify, and self-host it. Attribution back to [miaocut.app](https://miaocut.app) is appreciated but not required. The free tools, the website front end, and the CPU background-removal backend (`main.py`) in this repository are MIT-licensed. The paid batch service behind miaocut.app (credits, subscriptions, the GPU pipeline, and its API gateway) is developed in a separate private repository and is not open source. --- <p align="center"> <strong><a href="https://miaocut.app">miaocut.app</a></strong> · Free AI image tools that respect your privacy<br> Made with ❤️ by <a href="https://github.com/midcodehub">midcodehub</a> </p>