Copied
Docs

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

EMPLOYEE LOGIN
  • Home
  • Getting Started
    • User Management
    • Project Management
    • Asset Management
  • Annotate
  • Tasks
  • API
  • Recipes
  • Tutorials
  • Integrations

Uploading assets to Sama's AWS S3 bucket

Updated at February 16th, 2024

 

The annotation tasks that you create are most likely going to require assets, such as images and videos. Before you get started creating those tasks, you need to make sure that your assets are stored somewhere that the platform can access.

You can either upload your assets to our Sama's AWS S3 bucket, or have assets accessed from your own cloud storage.

Below are instructions if you'd like to upload assets to Sama's AWS S3 bucket directly. 
 


Gather your Sama info

For most clients, your Sama API Key and Project ID are required to upload assets to the S3 bucket. Reach out to your Sama Delivery Manager to get this information.

Uploading your assets with the AWS CLI

 

📘 Note

You can also upload your assets directly and create tasks using the Sama CLI.

 

 

Using the AWS CLI will give you the best performance when uploading your assets. The AWS CLI does have Python 3 as a requirement.

 

Install Python 3

Installation instructions directly from Python

On macOS, make sure to run Install Certificates.command after the installation.

 

Install the AWS CLI

Installation instructions directly from Amazon

 

Configure sama-aws tool

Download the sama-aws.py

Start a terminal. The configure command creates a Sama profile and AWS CLI will fetch temporary credentials from https://app.sama.com using your API key. It will auto-renew the credentials every hour.

python3 sama-aws.py configure

Look for Assets S3 URL in the command output, you will need it later.

 

Test AWS CLI sama profile.

aws --profile sama sts get-caller-identity 
aws --profile sama s3 ls <Assets S3 URL>

Upload assets

 

 

 

This command uploads the desired folder to your S3 dedicated prefix.

aws --profile sama s3 sync ./<folder_name> <Assets S3 URL>/<folder_name>

Installing CyberDuck

Install Cyberduck

Run the following command in a shell. It will create or update the sama-cyberduck AWS profile.

python3 sama-aws.py update-credentials-file
  • Add S3 (Credentials from AWS Command Line Interface) bookmark in Cyberduck
  • Set profile name as sama-cyberduck
  • Set path to Assets S3 URL as printed by the configure command, without the s3:// prefix.


 

asset transfer s3 storage

Was this article helpful?

Yes
No
Give feedback about this article
Gather your Sama info Uploading your assets with the AWS CLI Install Python 3 Install the AWS CLI Configure sama-aws tool Test AWS CLI sama profile. Upload assets Installing CyberDuck

The first B Corp-certified AI company

  • Security
  • Terms
  • Privacy
  • Quality & Information

Copyright © 2023 Samasource Impact Sourcing, Inc. All rights reserved.


Knowledge Base Software powered by Helpjuice

Expand