| # Deploy MolmoAct2 as a HuggingFace Docker Space |
|
|
| This folder IS the Space contents (`Dockerfile`, `README.md`, `requirements.txt`, |
| `molmoact2_server.py`). `molmoact2_server.py` is a copy of the canonical |
| `../molmoact2_server.py` — after editing the canonical server, re-copy it: |
|
|
| ```bash |
| cp ../molmoact2_server.py molmoact2_server.py |
| ``` |
|
|
| ## Target |
| Space `NoriRobotics/molmoact2-space` (private, Docker SDK, GPU hardware). |
|
|
| ## Path A — scripted (create repo + upload folder) |
| Uses the org token already in `nori-backend/.env` (`HF_ORG_ADMIN_TOKEN`), read |
| in-process, never printed. From `cloud_inference/space/`: |
|
|
| ```bash |
| python - <<'PY' |
| import os |
| from dotenv import load_dotenv |
| from huggingface_hub import HfApi |
| load_dotenv("/Users/michael/Documents/Nori-Robotics/nori-backend/.env") |
| api = HfApi(token=os.environ["HF_ORG_ADMIN_TOKEN"]) |
| repo = "NoriRobotics/molmoact2-space" |
| api.create_repo(repo, repo_type="space", space_sdk="docker", private=True, exist_ok=True) |
| api.upload_folder(repo_id=repo, repo_type="space", folder_path=".") |
| print("uploaded ->", repo) |
| PY |
| ``` |
|
|
| Creating the Space defaults to **free CPU** hardware; a CPU box cannot load the |
| model. After upload, finish in the UI (Path B steps 2-3). |
|
|
| ## Path B — UI |
| 1. huggingface.co → New Space → owner `NoriRobotics`, SDK **Docker**, **private**. |
| Clone it, copy this folder's files in, `git add . && git commit && git push`. |
| 2. **Settings → Variables and secrets**: add secret `NORI_INFER_TOKEN` (the bearer |
| token the rollout sends). Add `HF_TOKEN` only if the model repo is gated. |
| 3. **Settings → Hardware**: pick a GPU — `a10g-small` (~$1/hr) is enough. |
|
|
| ## Verify |
| First boot downloads ~21GB. Poll health (no auth needed): |
|
|
| ```bash |
| curl -s https://noribotics-molmoact2-space.hf.space/health |
| # {"ok":false,"status":"loading",...} -> {"ok":true,"status":"ready",...} |
| ``` |
|
|
| Smoke-test `/act` (needs the token; keep it out of shell history — read from a file): |
|
|
| ```bash |
| TOKEN=$(cat ~/.nori_infer_token) # or your secret manager |
| curl -s https://noribotics-molmoact2-space.hf.space/act \ |
| -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \ |
| -d '{"images":["<b64-jpeg>","<b64-jpeg>"],"state":[0,0,0,0,0,0], |
| "instruction":"pick up the red cup","num_steps":10}' |
| # -> {"actions":[[...6...], ...]} ~30 moves, robot scale |
| ``` |
|
|
| The exact subdomain is shown on the Space page (Embed → Direct URL). It is |
| `https://<owner>-<space-name>.hf.space`, lowercased with `/` → `-`. |
|
|
| ## Cost note |
| A GPU Space bills while **Running**. Set **Sleep after inactivity** in Settings |
| (e.g. 15 min) for the spike so it pauses when idle; the robot rollout wakes it |
| (cold start ≈ first-boot download unless persistent storage is attached). |
|
|
