Skip to main content
This guide walks you through the complete PixlHub workflow: project, data, labels, annotation. By the end you will have a working image project with your first annotations submitted for review.
You need a PixlHub account and a workspace. Every account starts with a default workspace; you can create more from the workspace switcher in the top navigation bar.
1

Create a project

Go to Projects and click New Project. Give the project a name, an optional description, and pick a Tool Type. The tool type decides which annotation editor opens for your tasks, so choose the one that matches your data: Image, LiDAR / Point Cloud, Text, or RLHF.
PixlHub New Project dialog with project name, description and tool type selection

The New Project dialog. This example creates an image project for street scene detection.

Click Create. PixlHub opens the project overview with a default workflow already in place: tasks move from Label to Review to Done.
2

Upload your data

Open the Assets tab and click Upload. Drag files in or browse, then confirm with Upload files.
PixlHub Upload Data dialog with eight image files selected and upload limits visible

The upload dialog shows file sizes, running totals and limits before anything is sent.

Two details worth knowing at this stage:
  • Batch name is optional but useful: it groups an upload so you can filter and export by batch later.
  • Current limits per upload: 500 files, 100 MB per file, 512 MB total. Supported image formats include JPG, PNG, GIF, WebP and SVG.
PixlHub creates one task per uploaded asset automatically. Thumbnails appear in the Assets grid as processing completes.
3

Define the label schema

Open the Label Schema tab and click Add Label for each class you need. Every label gets a color and a hotkey number (shown as “Hot: 1”, “Hot: 2” and so on) that you will use constantly in the editor.
PixlHub Label Schema tab with Pedestrian, Traffic Sign and Vehicle classes

Three classes with automatically assigned hotkeys. Expand a label to add attributes.

Click Save and confirm. Labels can be edited later, but renaming or removing classes after annotation has started affects existing annotations, so settle the taxonomy early.
4

Annotate your first task

Click Start Labeling in the project header. The annotation editor opens with your first task queued.The fastest loop for bounding boxes:
  1. Press the class hotkey (for example 3 for Vehicle).
  2. Click and drag on the image to draw the box.
  3. Repeat. Each annotation appears in Object Instances on the left with its class and ID.
PixlHub annotation editor with tight bounding boxes on vehicles, a pedestrian and a traffic sign in a street scene

A labeled street task: three vehicles, a pedestrian and a traffic sign, each drawn with its class hotkey and tracked in Object Instances.

5

Submit and keep going

You have two ways to finish:
  • Save stores your work without changing the task status. Use it when you are mid-task.
  • Submit & Next completes the task, sends it to the Review step of the workflow, and loads the next task in the queue.
Progress, throughput and per-class counts accumulate in the project Overview and Performance tabs as you work.

Next steps

Image annotation editor

Every panel, tool and shortcut in the image editor.

Bounding boxes

Standard, rotating and OCR-optimized box variants.

Project workflow

How tasks move from Label to Review to Done.

Exports

Get annotations out in the format your training pipeline expects.