> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Go from zero to your first Blob, Revision, and Workflow Execution in a few minutes.

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](/rest-api/introduction) and
the [Python SDK](/sdk/introduction).

<Steps>
  <Step title="Sign in to BlobHub">
    Open [blobhub.io](https://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.
  </Step>

  <Step title="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.

    <Tip>
      You can create multiple Organizations. Use them to separate personal experiments from team work, or to
      scope access for different collaborators.
    </Tip>
  </Step>

  <Step title="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](/blob-types/introduction) for the full list of available types.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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](/general/concepts#revisions-and-the-revision-lifecycle) for the full Draft →
    Commit → Snapshot lifecycle.
  </Step>

  <Step title="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.

    <Check>
      If the Execution completes successfully, you have just exercised the entire BlobHub platform stack —
      storage, versioning, execution, and real-time events.
    </Check>
  </Step>

  <Step title="(Optional) Call it from code">
    Once your Blob is snapshotted, you can drive the same loop programmatically. Install the Python SDK:

    ```bash theme={null}
    pip install blobhub
    ```

    Then use it (or the raw [REST API](/rest-api/introduction)) to create Sessions and Executions against
    your Blob from your own application or notebook.
  </Step>
</Steps>

## What You Just Built

```mermaid theme={null}
flowchart LR
    ORG["Organization<br/>acme"]
    BLOB[/"Workflow Blob<br/>hello-workflow"/]
    REV["Revision<br/>Draft → Commit → Snapshot"]
    SESS["Session"]
    EXEC["Execution"]
    EVT["Execution Events"]

    ORG --> BLOB --> REV --> SESS --> EXEC --> EVT
```

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

<CardGroup cols={2}>
  <Card title="Concepts" icon="book" href="/general/concepts">
    Get the full mental model of Organizations, Blobs, Revisions, and related primitives.
  </Card>

  <Card title="Blob Types" icon="layer-group" href="/blob-types/introduction">
    Explore Workflow, Scheduler, and ONNX Blob Types in depth.
  </Card>

  <Card title="REST API Reference" icon="code" href="/rest-api/introduction">
    Drive the same loop programmatically from any language.
  </Card>

  <Card title="Python SDK" icon="python" href="/sdk/introduction">
    Integrate BlobHub into Python applications and notebooks.
  </Card>
</CardGroup>