title: MeshScale
emoji: 🔩
colorFrom: gray
colorTo: yellow
sdk: docker
app_port: 7860
pinned: false
MeshScale
Bare-metal search surface for the MeshScale CPU worker mesh.
Required Space variable:
KEY_FARM_ROOT=/data/farm
Safe default:
MESHSCALE_ENABLE_APPLY=0
MESHSCALE_AUTOSCALE=0
Set MESHSCALE_ENABLE_APPLY=1 only on the controller Space that is allowed to
start or pause Hugging Face CPU worker Spaces.
Set MESHSCALE_AUTOSCALE=1 on that same controller when expansion requests
should be honored continuously instead of only through scale apply.
Operator write guard:
MESHSCALE_OPERATOR_TOKEN=<long random operator token>
MESHSCALE_REQUIRE_OPERATOR_TOKEN=true
When configured, mutating HTTP routes require X-MeshScale-Token. Read-only
status, dashboard, route, and plan endpoints stay open. The UI can store the
token locally with auth <token> and remove it with auth clear; the token is
not echoed into the output pane.
Common variables:
MESHSCALE_TEMPLATE_SPACE=tostido/meshscale-worker-template
MESHSCALE_SCALE_MODE=auto
MESHSCALE_REPLICA_SPACE=tostido/meshscale-worker-template
MESHSCALE_WORKER_POOL=tostido/meshscale-worker-template
MESHSCALE_MIN_REPLICAS=1
MESHSCALE_NAMESPACE=tostido
MESHSCALE_WORKER_PREFIX=meshscale-worker
MESHSCALE_HARDWARE=cpu-upgrade
MESHSCALE_MAX_WORKERS=24
MESHSCALE_BUDGET_HOURLY_USD=1.44
MESHSCALE_AUTOSCALE_SECONDS=30
MESHSCALE_BUCKET_SOURCE=tostido/Ouroboros-storage
MESHSCALE_BUCKET_MOUNT_PATH=/data
MESHSCALE_KEY_SPACE_URL=https://huggingface.co/spaces/tostido/Ouroboros
MESHSCALE_BUCKET_URL=https://huggingface.co/buckets/tostido/Ouroboros-storage
MESHSCALE_WORKER_TEMPLATE_URL=https://huggingface.co/spaces/tostido/meshscale-worker-template
auto mode tries replica scaling first. It drives:
POST https://huggingface.co/api/spaces/{namespace}/{repo}/replicas
against MESHSCALE_REPLICA_SPACE, avoiding the Hugging Face daily duplicate
repository cap. If Hugging Face rejects replica mutation for the current
account/token, MeshScale starts already-created workers listed in
MESHSCALE_WORKER_POOL. The old duplicate-repo path remains available with
MESHSCALE_SCALE_MODE=spaces.
The UI accepts search commands:
guide
status
trace
plan 420
scale <n>
scale 0
scale dry
scale apply
run
drain 4
shutdown
The OS route layer returns contextual next steps before acting. For example,
scale apply stops early when the controller pulse is quiet and routes the user
to KEY instead of blindly scaling workers.