DEPLOY.md

Deploy to HuggingFace Spaces

Quick Push

cd /Users/srayuth/git/bluweo/service/remove-background-hf

# Make changes, then:
git add .
git commit -m "Your message"
git push

Setup from Scratch

1. Clone HF Space

git clone https://huggingface.co/spaces/Pheerakarn/remove.bg
cd remove.bg

2. With Access Token (if needed)

# Get token from: https://huggingface.co/settings/tokens
git remote set-url origin https://Pheerakarn:YOUR_TOKEN@huggingface.co/spaces/Pheerakarn/remove.bg

3. Copy Files from Main Project

# From main project
cp Dockerfile.hf ../remove-background-hf/Dockerfile
cp requirements-hf.txt ../remove-background-hf/requirements.txt
cp .env.hf ../remove-background-hf/.env
cp -r config transparent scalar ../remove-background-hf/
cp manage.py gunicorn.conf.py yolov8n.pt ../remove-background-hf/

4. Push

git add .
git commit -m "Update"
git push

Hardware Options

Hardware	Specs	VRAM	Speed	Cost
CPU basic	2 vCPU · 16 GB RAM	-	~30-60s	Free
CPU upgrade	8 vCPU · 32 GB RAM	-	~15-30s	$0.03/hr
T4 small	4 vCPU · 15 GB RAM	16GB	~2-5s	$0.40/hr
T4 medium	8 vCPU · 30 GB RAM	16GB	~2-5s	$0.60/hr
L4	8 vCPU · 30 GB RAM	24GB	~1-3s	$0.80/hr
A10G small	4 vCPU · 15 GB RAM	24GB	~1-3s	$1.00/hr
A10G large	12 vCPU · 46 GB RAM	24GB	~1-3s	$1.50/hr
L40S	8 vCPU · 62 GB RAM	48GB	~0.5-2s	$1.80/hr
A100 large	12 vCPU · 142 GB RAM	80GB	~0.5-1s	$2.50/hr

Enable GPU: Settings → Hardware → Select GPU → Save

Files Structure

remove-background-hf/
├── Dockerfile          # HF Docker config
├── requirements.txt    # Python deps (GPU)
├── .env               # Environment vars
├── README.md          # HF metadata
├── manage.py          # Django entry
├── gunicorn.conf.py   # Server config
├── yolov8n.pt         # YOLO model
├── config/            # Django settings
├── transparent/       # API app
└── scalar/            # API docs

Troubleshooting

OMP_NUM_THREADS Error

Fixed in transparent/apps.py - converts HF's "3500m" to "4"

GPU Not Detected

• Check hardware is enabled in Settings
• Wait for Space to fully restart after hardware change

Build Failed

• Check logs in HF Space
• Verify Dockerfile syntax
• Check requirements.txt versions

API Endpoints

• Docs: https://pheerakarn-remove-bg.hf.space/api/docs/
• Health: https://pheerakarn-remove-bg.hf.space/api/transparent/health/
• Generate: POST /api/transparent/generate-styles/