DEPLOY.md

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:

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/:

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):

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):

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).