How to run an app from the workspace.
Open the app
Find it in the Grid and click to open.
Fill in inputs
Each app has a form with required and optional fields:
1stable-diffusion23Prompt: [________________________] ← required45Style: [Photorealistic ▼] ← optional67Size: [1024 x 1024 ▼] ← optionalChoose where to run
| Option | Description |
|---|---|
| Cloud | Runs on inference shell workers |
| Private | Runs on your own hardware |
Toggle at the top of the runner.
Click Run
The task starts. You'll see:
- Status — Queued → Running → Complete
- Progress — Percentage and logs
- Results — Outputs when done
Download results
Files (images, audio, etc.) have download buttons.
Click to save to your computer.
View in Tasks
All runs appear in Tasks.
Go there to see history or re-download results.
From the CLI
Run the same app from your terminal (after CLI setup):
1infsh app run namespace/my-app --input input.json2infsh app run namespace/my-app '{"prompt": "a sunset"}' # positional JSON3echo '{"prompt": "a sunset"}' | infsh app run namespace/my-app # piped stdin4belt app run namespace/my-app -i '{"prompt": "a sunset"}' --jq '.output.url' # filter outputBy default the CLI waits until the task completes and prints the output. For long-running jobs, return immediately and follow progress separately:
1infsh app run namespace/my-app@version --input input.json --no-wait2belt task get <task-id> -f # status, logs, and output until complete3belt task logs <task-id> -f # logs only (filter with --type run, setup, etc.)Input resolves from --input, a positional argument, or piped stdin (in that order). Each accepts inline JSON, @filename, or a JSON file path. See CLI setup — JSON input and Tasks for status codes, cancellation, and webhooks.
When output includes file URLs (images, audio, video), download them with belt file download <url> — see CLI setup — Files.
Cancel a run
While status is Running, click Cancel in the runner or on the task detail page. The platform requests a graceful stop; see Tasks for API, CLI (belt task cancel), and MCP cancellation.