Ango Hub Docs
Open Ango HubContact iMerit
  • Ango Hub Documentation
  • Video Guides
  • Changelog
  • FAQs & Troubleshooting
  • All Keyboard and Mouse Shortcuts
  • Core Concepts
    • Assets
    • Attachments
    • Batches
    • Benchmarks
    • Category Schema (Ontologies)
    • Frame Interpolation
    • Geofencing
    • Idle Time Detection & Time Tracking
    • Instructions
    • Issues
      • Issue Error Codes
    • Label Validation
    • Labeler Performance
    • Labeling
    • Labeling Queue
    • Multiple Classification
    • Notifications
    • Organizations
    • Projects
    • Requeuing
    • Reviewing
    • Review Queue
    • Skipping
    • Stage History
    • Tasks
    • Usage
    • User Roles
    • Workflow
      • Complete
      • Consensus
      • Hold
      • Label
      • Logic
      • Plugin
      • Review
      • Start
      • Webhook
  • Labeling
    • Managing Users in Projects
      • Profile Page
    • Managing the Project Ontology
    • Labeling Editor Interface
      • Audio Labeling Editor
      • Image Labeling Editor
      • Video Labeling Editor
      • DICOM Labeling Editor
      • Medical Labeling Editor
        • 3D Bounding Box
        • Fill Between Slices
        • Island Tools
        • Line (Tape Measure)
        • Smoothing
      • PDF Labeling Editor
      • Text (NER) Labeling Editor
      • LLM Chat Labeling Editor
      • Markdown Labeling Editor
      • 3D Multi-Sensor Fusion Labeling Editor
    • Labeling Classes
      • Tools
        • Bounding Box
        • Brush
        • Entity
        • Message
        • Nested Classifications
        • PCT
        • PDF Tool
        • Point
        • Polygon
        • Polyline
        • Rotated Bounding Box
        • Segmentation
        • Spline
        • Voxel Brush
      • Classification
        • Checkbox
        • Multiple Dropdown
        • Radio
        • Rank
        • Single Dropdown
        • Text
        • Tree Dropdown Tools (Single and Multiple Selection)
      • Relation
        • Single Relation
        • Group Relation
    • Magnetic Lasso
    • Performance & Compatibility Considerations
  • Data
    • Data in Ango Hub
      • Embedding Private Bucket Files in MD Assets
    • Importing Assets
      • Asset Builder
      • Bundled Assets
        • Importing Multiple Images as One Multi-Page Asset
        • Importing Multiple Single-Frame DICOM Files as One Multi-Page Asset
        • Importing multiple DICOM files to be annotated and displayed at once
        • Importing Multiple Single-Frame DICOM Files as a DICOM Series
        • Importing Multiple Markdown Files as One Multi-Page Asset
      • File Explorer
      • Supported Asset File Types & Codecs
      • Importing Cloud (Remote) Assets
      • Importing From Local Machine
      • Creating and Importing LLM Chat Assets
      • Importing Data in the 3D Multi-Sensor Fusion Labeling Tool
      • Bulk Importing Markdown/HTML Assets
      • Importing Attachments during Asset Import
      • Importing Annotations during Asset Import
      • contextData: Adding Extra Data to Assets
      • Importing Reference Images as Overlay
      • Importing Reference Medical Data During Asset Import
    • Importing and Exporting Annotations
      • Importing Annotations
        • Ango Import Format
        • Importing Brush Traces
        • Importing NRRD Annotations
      • Exporting Annotations
        • Ango Export Format
          • Asset
            • Task
              • Tools
              • Classifications
              • Relations
          • Stage History
    • Adding and Managing LLMs
    • Storages
      • Set up a storage integration with Azure
      • Set up a storage integration with AWS S3
      • Set up a storage integration with MinIO and S3-compatible custom storage services
      • Set up a storage integration with GCP (Google Cloud Platform)
      • Set up CORS
      • Validating Storage Integrations
    • Purging Data from Ango Hub
  • Plugins
    • Overview of Plugins in Ango Hub
      • Installing Plugins
      • Plugin Setting Presets
      • Monitoring Plugin Progress
    • First-Party Plugins
      • Ango Export Converter Plugins
      • Asset Converter Plugins
      • Ango to Mask Converter
      • Batch Assignment
      • ChatGPT
      • Column-Agnostic Markdown Generator
      • CSV Export for Classification
      • DALL-E
      • DALL-E (Model Plugin)
      • File Explorer Plugin
      • General Object Detector
      • General Object Segmenter
      • Markdown Generator
      • One-Click Segmentation
      • Open World Object Detection
      • Optical Character Recognition
      • TPT Export
      • YOLO | Instance Segmentation
      • YOLO | Pose Estimation
      • YOLO | Object Detection
      • YOLO | Image Classification
    • Plugin Developer Documentation
      • Export Plugins
      • Batch Model Plugins
      • Model Plugins
      • File Explorer Plugins
      • Markdown Generator Plugins
      • Plugin Logger
      • [WIP] Deploying your Plugin
      • Plugin 'Host' Information
  • SDK
    • SDK Documentation
      • Project Level SDK Functions
        • add_members_to_project
        • assign_batches
        • assign_task
        • create_attachment
        • create_batch
        • create_issue
        • create_label_set
        • create_project
        • delete_issue
        • export
        • exportV3
        • get_assets
        • get_batches
        • get_issues
        • get_metrics
        • get_project
        • get_project_performance
        • get_task
        • get_tasks
        • get_task_history
        • import_labels
        • list_projects
        • requeue_tasks
        • rerun_webhook
        • update_workflow_stages
        • upload_files
        • upload_files_cloud
        • upload_files_with_asset_builder
        • upload_chat_assets
      • Organization Level SDK Functions
        • create_storage
        • delete_organization_invites
        • delete_organization_members
        • delete_storage
        • get_organization_invites
        • get_organization_members
        • get_storages
        • invite_members_to_org
        • update_organization_members_role
    • SDK - Useful Snippets
    • SDK Changelog
  • API
    • API Documentation
  • How-To
    • Add Members
      • Add multiple users to a project
    • Annotate
      • Annotate 3D Point Cloud Files on Ango Hub
      • Perform targeted OCR on images
    • Export Data
      • Automatically send Ango Hub Webhook contents to Google Sheets, Email, Slack, and more with Zapier
      • Download a JSON of your project ontology
      • Download DICOM Segmentation Masks
      • Download your annotations in the COCO, KITTI, or YOLO format
      • Download your Segmentation Masks
      • Get your export as separate JSON files for each asset
    • Manage a Project
      • Get your API Key
      • Get your Organization ID
      • Mute your notifications
      • Open an asset provided the Asset ID
      • Pre-label assets
      • Share a filtered view of the Tasks table with others
      • Transfer project ontologies between projects
      • Transfer project workflows between projects
    • Perform Model Evaluation on Ango Hub
  • Troubleshooting
    • I get a "0 Tasks Labeled" alert when trying to pre-label tasks
    • I get a 'The data couldn't be loaded properly' error when opening certain assets
    • I get a "Unknown Classification" warning when opening a task
  • Feature Availability Status for projects of the 3D Multi-Sensor Fusion type
  • Comparison between QuickServe and Ango Hub
  • Changes from Ango Hub Legacy
  • Video V2 Breaking Changes and Transition
  • Data Access, Storage, and Security
  • Two-Factor Authentication
  • Single Sign-On (SSO) Support
  • Customer Support
  • Ango Hub Status Page
Powered by GitBook
On this page
  • Steps for Importing Cloud (Remote) Assets
  • Step 0: Set Up the Storage Integration (private files only)
  • Step 1: Preparing the JSON
  • Step 2: Uploading the JSON to Ango Hub
  1. Data
  2. Importing Assets

Importing Cloud (Remote) Assets

Overview of importing publicly available assets into Ango Hub

PreviousSupported Asset File Types & CodecsNextImporting From Local Machine

Last updated 1 month ago

Administrators and project managers can import files (i.e. assets) to Ango Hub without them ever leaving their current storage location.

You may import both publicly available assets this way (e.g. public, open links to files, like, for example, ) or assets located in private buckets in AWS S3, Google Cloud Platform, or Microsoft Azure.

The main difference between importing data from cloud storage services and using drag-and-drop is the file location. When , the assets are uploaded to iMerit's private AWS S3 storage in Germany. When importing assets from your own cloud storage, however, your assets are left in your own storage and are never copied anywhere else.

Steps for Importing Cloud (Remote) Assets

If you are importing public assets, you may start at the .

If you are importing private assets, (i.e. located in private storage buckets in AWS S3, GCP, or Azure), please start at .

Step 0: Set Up the Storage Integration (private files only)

This step is only necessary if you are attempting to import files located in private cloud storages.

Please create a between Ango Hub and your bucket. Instructions on how to do so can be found here:

After having created the storage integration and having saved it in Ango Hub, as per the instructions linked, before moving on to the next steps, please ensure that the bucket you are trying to connect has a CORS policy which allows Ango Hub to display the files. More information on how to set up CORS for your bucket can be found here: .

Step 1: Preparing the JSON

Ensure your URLs are percent-encoded in the UTF-8 format.

If your filenames contain spaces, for example, ensure they are encoded as %20, and not as pluses (+).

For private files in AWS S3 buckets, ensure the region information is present in the URLs you provide in the JSON.

The URL must be in the format https://<bucket-name>.s3.<region>.amazonaws.com/<path-to-file>

If you do not provide region information, Hub will assume the region is us-east-1.

This is what the minimal working JSON looks like:

[
  {
   "data":"https://url-to-asset.com/CzXTtJV.jpg",
   "externalId":"cute-cat.jpg"
  },
  {
   "data":"https://url-to-asset.com/OB0y6MR.jpg",
   "externalId":"cute-dog.jpg"
  }
]

Considerations when importing video files

If you already have each video's metadata at hand, however, you may choose to provide this metadata in the import JSON such that Ango Hub can skip the metadata check and use the metadata you provided.

The JSON with the optional metadata is as follows:

[
  {
   "data":"https://url-to-asset.com/CzXTtJV.mp4",
   "externalId":"cute-cat.mp4",
   "metadata": {
     "frameRate": 24,   // Can be an integer or a floating point value
     "frameCount": 150, // Must be an integer
     "width": 450,      // Can be an integer or a floating point value
     "height": 450      // Can be an integer or a floating point value
   }
  },
  ...
]

Videos provided with all of the above metadata will not be processed for metadata and will therefore be available earlier for annotation.

Adding custom data to assets on import (contextData)

Assigning individual assets to batches on import

If, however, you'd like to specify batch(es) for individual assets as you import them, you may do so by adding a batches array property to the JSON like so:

[
  {
   "data":"https://url-to-asset.com/CzXTtJV.mp4",
   "externalId":"cute-cat.mp4",
   "batches": [
      "batchId1"
    ]
  },
  {
   "data":"https://url-to-asset.com/2.mp4",
   "externalId":"asset-2.mp4",
   "batches": [
      "batchId1", "batchId2"
    ]
  }
]

In the case above, the first asset will be added to the batch called batchId1 and the second asset to two batches: batchId1 and batchId2.

Importing pre-labels during asset import

You may include pre-labels as you prepare the JSON for importing assets.

Importing attachments during asset import

You may add video, image, or text attachments to the assets you are uploading as you prepare the JSON. Attachments will be displayed next to the main asset.

Importing multiple images as a single asset

You may make it so that multiple images appear as a carousel to annotators. Images uploaded this way will form 'pages' of a larger asset.

This is useful if you wish for the same annotator to annotate a series of images in a row. It also brings additional benefits such as being able to quickly clone annotations from one image to another, and more.

Importing multiple Markdown (HTML) files as a single asset

You may make it so that multiple markdown files appear in a bundle to annotators. Files uploaded this way will form 'pages' of a larger asset.

This is useful if you wish for the same annotator to annotate a series of files in a row.

Importing reference images which can be overlayed on top of the main image

You may add reference images in such a way that the annotator, while they are annotating the main image, are able to overlay additional reference images on top.

Step 2: Uploading the JSON to Ango Hub

From your project’s dashboard, enter the Assets tab and click on Add Data.

A dialog will pop up. Click on “Cloud Storage” at the top.

Drag the JSON file you would like to upload to the box in the center. Alternatively, click on the box to open your system’s file explorer and select it from there.

Click on the Upload button. Your assets will appear in the Assets tab.

Before importing the assets to Ango Hub, you will need to prepare a JSON file containing each asset’s as well as the asset's full absolute path.

When importing video files, in one of the , Ango Hub performs a metadata check to extract various metadata (e.g. width, height, frame rate, frame total). For large video files, this check can last a few seconds per file – thus if you are importing a very large number of large video files, the metadata check can take a significant amount of time.

You may add custom key-value pairs when uploading each asset. This data, while not displayed in the UI in Ango Hub, will be stored and returned when obtaining the final export. We call this .

Please refer to the for more details about this feature.

are a way Ango Hub allows project managers to logically bundle assets. Batches are like tags you may apply to assets to group them together. You may assign any asset to any number of batches.

If you wish to add all assets you are uploading with the JSON to the same batch, you may do so in from the UI.

See the for more information.

See this docs page on how to accomplish this: .

See this docs page on how to accomplish this: and read more about attachments .

Please see this docs page on how to accomplish this and on more details about multi-page assets:

Please see this docs page on how to accomplish this and on more details about this feature:

Please see this docs page on how to accomplish this and on more details about this feature:

If you are uploading a JSON containing links to private assets, you must also pick the storage integration you created in from the Storage Method dropdown on the left.

It is also possible to upload assets through our .

supported formats
contextData
docs page on contextData
Batches
docs page on batches
Importing Annotations during Asset Import
Importing Attachments during Asset Import
here
Importing Multiple Images as One Multi-Page Asset
Importing Multiple Markdown Files as One Multi-Page Asset
Importing Reference Images as Overlay
API
https://i.imgur.com/CzXTtJV.jpg
importing assets with drag-and-drop
Storage Integration
Create a storage integration between Ango Hub and a private AWS S3 bucket
Create a storage integration between Ango Hub and a private Google Cloud Platform bucket
Create a storage integration between Ango Hub and a private Microsoft Azure bucket
Create a storage integration between Ango Hub and a MinIO or S3-compatible custom storage
Set Up CORS
Step 1: Preparing the JSON
Step 0: Setting Up the Storage Integration
Step 2
Step 0
external ID