---
title: sam3-gradio-cpu
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 6.3.0
python_version: 3.12
app_file: app.py
suggested_hardware: cpu-basic
pinned: false
---

# SAM3 Gradio (CPU-only)

This Space is configured for CPU-only usage. The Gradio app lives in `app.py`.

## Model access (HF token)

`facebook/sam3` is gated. On Hugging Face Spaces, add a Space secret named `HF_TOKEN` (or `HUGGINGFACE_HUB_TOKEN`) with a token that has accepted the model terms.

Local setup (from this folder):

```bash
python -m venv .venv
source .venv/bin/activate
python -m ensurepip --upgrade
python -m pip install -r requirements.txt
python app.py
```

## API usage

Gradio exposes HTTP endpoints for event handlers. The easiest client is `gradio_client`:

```bash
python examples/call_space_gradio_client.py --space https://tamarher-sam3-cpu.hf.space --image-url https://raw.githubusercontent.com/gradio-app/gradio/main/test/test_files/bus.png --prompt bus
```

If you prefer `requests`, use the `/gradio_api/call/...` SSE endpoint:

```bash
python examples/call_space_requests.py --base https://tamarher-sam3-cpu.hf.space --image-url https://raw.githubusercontent.com/gradio-app/gradio/main/test/test_files/bus.png --prompt bus
```