Supervisely
AboutAPI ReferenceSDK Reference
  • 🤖What's Supervisely
  • 🚀Ecosystem of Supervisely Apps
  • 💡FAQ
  • 📌Getting started
    • How to import
    • How to annotate
    • How to invite team members
    • How to connect agents
    • How to train models
  • 🔁Import and Export
    • Import
      • Overview
      • Import using Web UI
      • Supported annotation formats
        • Images
          • 🤖Supervisely JSON
          • 🤖Supervisely Blob
          • COCO
          • Yolo
          • Pascal VOC
          • Cityscapes
          • Images with PNG masks
          • Links from CSV, TXT and TSV
          • PDF files to images
          • Multiview images
          • Multispectral images
          • Medical 2D images
          • LabelMe
          • LabelStudio
          • Fisheye
          • High Color Depth
        • Videos
          • Supervisely
        • Pointclouds
          • Supervisely
          • .PCD, .PLY, .LAS, .LAZ pointclouds
          • Lyft
          • nuScenes
          • KITTI 3D
        • Pointcloud Episodes
          • Supervisely
          • .PCD, .PLY, .LAS, .LAZ pointclouds
          • Lyft
          • nuScenes
          • KITTI 360
        • Volumes
          • Supervisely
          • .NRRD, .DCM volumes
          • NIfTI
      • Import sample dataset
      • Import into an existing dataset
      • Import using Team Files
      • Import from Cloud
      • Import using API & SDK
      • Import using agent
    • Migrations
      • Roboflow to Supervisely
      • Labelbox to Supervisely
      • V7 to Supervisely
      • CVAT to Supervisely
    • Export
  • 📂Data Organization
    • Core concepts
    • MLOps Workflow
    • Projects
      • Datasets
      • Definitions
      • Collections
    • Team Files
    • Disk usage & Cleanup
    • Quality Assurance & Statistics
      • Practical applications of statistics
    • Operations with Data
      • Data Filtration
        • How to use advanced filters
      • Pipelines
      • Augmentations
      • Splitting data
      • Converting data
        • Convert to COCO
        • Convert to YOLO
        • Convert to Pascal VOC
    • Data Commander
      • Clone Project Meta
  • 📝Labeling
    • Labeling Toolboxes
      • Images
      • Videos 2.0
      • Videos 3.0
      • 3D Point Clouds
      • DICOM
      • Multiview images
      • Fisheye
    • Labeling Tools
      • Navigation & Selection Tools
      • Point Tool
      • Bounding Box (Rectangle) Tool
      • Polyline Tool
      • Polygon Tool
      • Brush Tool
      • Mask Pen Tool
      • Smart Tool
      • Graph (Keypoints) Tool
      • Frame-based tagging
    • Labeling Jobs
      • Labeling Queues
      • Labeling Consensus
      • Labeling Statistics
    • Labeling with AI-Assistance
  • 🤝Collaboration
    • Admin panel
      • Users management
      • Teams management
      • Server disk usage
      • Server trash bin
      • Server cleanup
      • Server stats and errors
    • Teams & workspaces
    • Members
    • Issues
    • Guides & exams
    • Activity log
    • Sharing
  • 🖥️Agents
    • Installation
      • Linux
      • Windows
      • AMI AWS
      • Kubernetes
    • How agents work
    • Restart and delete agents
    • Status and monitoring
    • Storage and cleanup
    • Integration with Docker
  • 🔮Neural Networks
    • Overview
    • Inference & Deployment
      • Overview
      • Supervisely Serving Apps
      • Deploy & Predict with Supervisely SDK
      • Using trained models outside of Supervisely
    • Model Evaluation Benchmark
      • Object Detection
      • Instance Segmentation
      • Semantic Segmentation
      • Custom Benchmark Integration
    • Custom Model Integration
      • Overview
      • Custom Inference
      • Custom Training
    • Legacy
      • Starting with Neural Networks
      • Train custom Neural Networks
      • Run pre-trained models
  • 👔Enterprise Edition
    • Get Supervisely
      • Installation
      • Post-installation
      • Upgrade
      • License Update
    • Kubernetes
      • Overview
      • Installation
      • Connect cluster
    • Advanced Tuning
      • HTTPS
      • Remote Storage
      • Single Sign-On (SSO)
      • CDN
      • Notifications
      • Moving Instance
      • Generating Troubleshoot Archive
      • Storage Cleanup
      • Private Apps
      • Data Folder
      • Firewall
      • HTTP Proxy
      • Offline usage
      • Multi-disk usage
      • Managed Postgres
      • Scalability Tuning
  • 🔧Customization and Integration
    • Supervisely .JSON Format
      • Project Structure
      • Project Meta: Classes, Tags, Settings
      • Tags
      • Objects
      • Single-Image Annotation
      • Single-Video Annotation
      • Point Cloud Episodes
      • Volumes Annotation
    • Developer Portal
    • SDK
    • API
  • 💡Resources
    • Changelog
    • GitHub
    • Blog
    • Ecosystem
Powered by GitBook
On this page

Was this helpful?

  1. Getting started

How to import

Explore various import methods on the Supervisely Platform, including importing different formats and modalities, importing from the cloud or via Ecosystem apps.

PreviousFAQNextHow to annotate

Last updated 3 months ago

Was this helpful?

This 5-minute tutorial is a part of introduction to Supervisely series. You can complete them one-by-one, in random order, or jump to the rest of the documentation at any moment.

  • How to import (you are here)

You can learn more about Import, such as importing different formats, import from the cloud or adding data to existing datasets in

Supported formats and modalities

Image Datasets
  • Auto-detect annotations in , , , , , .

  • Import images for , , labeling.

  • Upload images as or .

  • Images in any directory structure without annotations.

  • Supported image formats: .jpg, .jpeg, jpe, .bmp, .png, .webp, .mpo, .tiff, .nrrd, .jfif, .avif, .heic.

Video Datasets
  • Auto-detect annotations in , DAVIS (coming soon), MOT (coming soon) formats.

  • Videos in any directory structure without annotations.

  • Supported video formats: .avi, .mov, .wmv, .webm, .3gp, .mp4, .flv. ⚠️ All videos will be converted to .mp4 format during import.

Point Cloud Datasets
  • Auto-detect annotations in format.

  • Point clouds in any directory structure without annotations in PCD, LAS, LAZ, PLY formats.

Point Cloud Episode Datasets
  • Point cloud episodes without annotations in PCD format.

Volume Datasets
  • Volumes in any directory structure without annotations in DICOM, NRRD formats.

🪄 Here we will look at the fastest and easiest import option!


  1. Click the Import Data button. Enter a unique name for the project, keeping in mind that it must be unique in the workspace and case-sensitive. You can also add a description of the project to provide additional information or to track project updates.

  2. Next, select the Project type by defining the content modality: images, videos, point clouds, or DICOM 3D volumes.

Note that you can't mix multiple content types in the same project, and this setting can't be changed later.

  1. Choose one of the available interfaces for labeling images (or other data modality). Our interfaces are designed for different industries and annotation scenarios.

  2. After completing all required fields and selecting options, click Create to complete the project and begin uploading data.

  1. In the modal window, drag and drop one or more images in one of the supported formats, such as .jpg, .jpeg, .mpo, .bmp, .png, .webp, .tiff, .tif, .nrrd, .jfif, .avif, .heic, NIfTI, DICOM . You can also check out the supported annotation formats.

🤗 Congratulations, the hardest part is over!

You can click three dots (⋮) icon and check the application logs.

🤓 Nerd alert! Skip this section if you aren't interested how Supervisely works inside.

So what is going on here? First, Supervisely will choose one of the connected Agents and ask it to run the “Auto Import'' application. It will spawn a Docker container that will download the GitHub repository with the application code and run python code written with Supervisely SDK.

It will pull your images uploaded to the Team Files in the modal window, convert them, if needed (this particular application maybe does little, but others, like Import COCO format, will transform a lot) and use API to create a Project and add images to it.

Once the import is finished, you will see the link to your new project in the Output column of the table.

Auto-detect annotations in format.

Auto-detect annotations in format.

You can always use applications to import different formats and modalities from our :

| | | | | | | | | and .

Let's start our journey with Supervisely by uploading our very first image. Of course, like we said before, you can import more complex dataset formats like , or modalities, such as DICOM, connect a S3 cloud and much more, but let’s begin with a simple one.

We assume that you have already created an account in Supervisely. If not, you can create a free account in our Community Edition

First thing you will see after you login to Supervisely, is your page where you can find your data. But there is nothing here yet — let’s fix that!

You will be redirected to the Tasks page where you can watch the progress of the application (your files are actually being uploaded to your ).

All set! Now, in the , let’s annotate your uploaded images.

📌
How to annotate
How to invite team members
How to connect agents
How to train models
this section.
Supervisely
COCO
YOLO
Pascal VOC
Cityscapes
Images with PNG masks formats
Multiview
Multispectral
Medical 2D (single)
links from CSV or TXT files
convert PDF pages to images
Supervisely
Supervisely
Supervisely
Supervisely
Ecosystem
Import Images
Import Videos
Import Pointclouds
Import Pointcloud Episodes
Import DICOM Volumes
Import COCO Keypoints
Import Volumes in Supervisely format
Import KITTI-360
Import Multispectral Images
many other formats
COCO
here.
Projects
Team Files
next section