Skip to main content
This quickstart walks you end to end through the core BlobHub loop — create an Organization, create a Blob, commit a Revision, run an Execution, and observe the result — using the web application. Once you have done it once in the UI, the same flow is available through the REST API and the Python SDK.
1

Sign in to BlobHub

Open blobhub.io and sign in. You can use Google sign-in or continue anonymously if you just want to poke around. Your personal profile is created automatically on first sign-in.
2

Create an Organization

Every Blob lives inside an Organization. From your profile, create a new Organization — give it a short, URL-friendly alias (for example acme). The alias becomes part of every Blob URL inside it.
You can create multiple Organizations. Use them to separate personal experiments from team work, or to scope access for different collaborators.
3

Create your first Blob

Inside your Organization, create a new Blob and choose its Blob Type. For this quickstart, pick Workflow — it gives you something you can immediately execute. Give the Blob an alias (for example hello-workflow).See Blob Types for the full list of available types.
4

Edit the Draft Revision

Every Blob starts with a Draft Revision. Open the visual editor and drop in a couple of components — for example a Flow Start, a Code block that returns a simple value, and a Flow End. Connect them in order.The Draft stays mutable until you commit it, so feel free to iterate.
5

Commit and Snapshot the Revision

When you are happy with the Draft, commit it. Committing freezes the Revision’s content. Then snapshot it to publish an addressable, immutable version of the Blob.See Concepts → Revisions for the full Draft → Commit → Snapshot lifecycle.
6

Run your first Execution

Open the Workflow Blob’s playground, create a Session, and start an Execution. You should see Execution Events stream in real time as components run.
If the Execution completes successfully, you have just exercised the entire BlobHub platform stack — storage, versioning, execution, and real-time events.
7

(Optional) Call it from code

Once your Blob is snapshotted, you can drive the same loop programmatically. Install the Python SDK:
pip install blobhub
Then use it (or the raw REST API) to create Sessions and Executions against your Blob from your own application or notebook.

​
What You Just Built

This is the core loop for every Workflow Blob. Scheduler Blobs add time-based triggering on top of it, and ONNX Blobs swap the executable content for versioned model files — but the Organization → Blob → Revision shape stays the same everywhere.

​
Next Steps

Concepts

Get the full mental model of Organizations, Blobs, Revisions, and related primitives.

Blob Types

Explore Workflow, Scheduler, and ONNX Blob Types in depth.

REST API Reference

Drive the same loop programmatically from any language.

Python SDK

Integrate BlobHub into Python applications and notebooks.