图像背景移除工具：一个简单且实用的工具，专门用于移除图像背景或进行抠图

# Rembg [](https://img.shields.io/pypi/dm/rembg.svg) [](https://img.shields.io/badge/License-MIT-blue.svg) [](https://huggingface.co/spaces/KenjieDec/RemBG) [](https://bgremoval.streamlit.app/) Rembg is a tool to remove images background. <p style="display: flex;align-items: center;justify-content: center;"> <img alt="example car-1" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/car-1.jpg" width="100" /> <img alt="example car-1.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/car-1.out.png" width="100" /> <img alt="example car-2" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/car-2.jpg" width="100" /> <img alt="example car-2.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/car-2.out.png" width="100" /> <img alt="example car-3" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/car-3.jpg" width="100" /> <img alt="example car-3.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/car-3.out.png" width="100" /> </p> <p style="display: flex;align-items: center;justify-content: center;"> <img alt="example animal-1" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/animal-1.jpg" width="100" /> <img alt="example animal-1.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/animal-1.out.png" width="100" /> <img alt="example animal-2" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/animal-2.jpg" width="100" /> <img alt="example animal-2.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/animal-2.out.png" width="100" /> <img alt="example animal-3" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/animal-3.jpg" width="100" /> <img alt="example animal-3.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/animal-3.out.png" width="100" /> </p> <p style="display: flex;align-items: center;justify-content: center;"> <img alt="example girl-1" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/girl-1.jpg" width="100" /> <img alt="example girl-1.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/girl-1.out.png" width="100" /> <img alt="example girl-2" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/girl-2.jpg" width="100" /> <img alt="example girl-2.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/girl-2.out.png" width="100" /> <img alt="example girl-3" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/girl-3.jpg" width="100" /> <img alt="example girl-3.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/girl-3.out.png" width="100" /> </p> <p style="display: flex;align-items: center;justify-content: center;"> <img alt="example anime-girl-1" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/anime-girl-1.jpg" width="100" /> <img alt="example anime-girl-1.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/anime-girl-1.out.png" width="100" /> <img alt="example anime-girl-2" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/anime-girl-2.jpg" width="100" /> <img alt="example anime-girl-2.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/anime-girl-2.out.png" width="100" /> <img alt="example anime-girl-3" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/anime-girl-3.jpg" width="100" /> <img alt="example anime-girl-3.out" src="https://raw.githubusercontent.com/danielgatis/rembg/master/examples/anime-girl-3.out.png" width="100" /> </p> **If this project has helped you, please consider making a [donation](https://www.buymeacoffee.com/danielgatis).** ## Sponsor <table> <tr> <td align="center" vertical-align="center"> <a href="https://photoroom.com/api/remove-background?utm_source=rembg&utm_medium=github_webpage&utm_campaign=sponsor" > <img src="https://font-cdn.photoroom.com/media/api-logo.png" width="120px;" alt="Unsplash" /> </a> </td> <td align="center" vertical-align="center"> <b>PhotoRoom Remove Background API</b> <br /> <a href="https://photoroom.com/api/remove-background?utm_source=rembg&utm_medium=github_webpage&utm_campaign=sponsor">https://photoroom.com/api</a> <br /> <p width="200px"> Fast and accurate background remover API<br/> </p> </td> </tr> </table> ## Requirements ```text python: >3.7, <3.13 ``` ## Installation CPU support: ```bash pip install rembg # for library pip install rembg[cli] # for library + cli ``` GPU support: First of all, you need to check if your system supports the `onnxruntime-gpu`. Go to <https://onnxruntime.ai> and check the installation matrix. <p style="display: flex;align-items: center;justify-content: center;"> <img alt="onnxruntime-installation-matrix" src="https://raw.githubusercontent.com/danielgatis/rembg/master/onnxruntime-installation-matrix.png" width="400" /> </p> If yes, just run: ```bash pip install rembg[gpu] # for library pip install rembg[gpu,cli] # for library + cli ``` ## Usage as a cli After the installation step you can use rembg just typing `rembg` in your terminal window. The `rembg` command has 4 subcommands, one for each input type: - `i` for files - `p` for folders - `s` for http server - `b` for RGB24 pixel binary stream You can get help about the main command using: ```shell rembg --help ``` As well, about all the subcommands using: ```shell rembg <COMMAND> --help ``` ### rembg `i` Used when input and output are files. Remove the background from a remote image ```shell curl -s http://input.png | rembg i > output.png ``` Remove the background from a local file ```shell rembg i path/to/input.png path/to/output.png ``` Remove the background specifying a model ```shell rembg i -m u2netp path/to/input.png path/to/output.png ``` Remove the background returning only the mask ```shell rembg i -om path/to/input.png path/to/output.png ``` Remove the background applying an alpha matting ```shell rembg i -a path/to/input.png path/to/output.png ``` Passing extras parameters ```shell SAM example rembg i -m sam -x '{ "sam_prompt": [{"type": "point", "data": [724, 740], "label": 1}] }' examples/plants-1.jpg examples/plants-1.out.png ``` ```shell Custom model example rembg i -m u2net_custom -x '{"model_path": "~/.u2net/u2net.onnx"}' path/to/input.png path/to/output.png ``` ### rembg `p` Used when input and output are folders. Remove the background from all images in a folder ```shell rembg p path/to/input path/to/output ``` Same as before, but watching for new/changed files to process ```shell rembg p -w path/to/input path/to/output ``` ### rembg `s` Used to start http server. ```shell rembg s --host 0.0.0.0 --port 7000 --log_level info ``` To see the complete endpoints documentation, go to: `http://localhost:7000/api`. Remove the background from an image url ```shell curl -s "http://localhost:7000/api/remove?url=http://input.png" -o output.png ``` Remove the background from an uploaded image ```shell curl -s -F file=@/path/to/input.jpg "http://localhost:7000/api/remove" -o output.png ``` ### rembg `b` Process a sequence of RGB24 images from stdin. This is intended to be used with another program, such as FFMPEG, that outputs RGB24 pixel data to stdout, which is piped into the stdin of this program, although nothing prevents you from manually typing in images at stdin. ```shell rembg b i