We've made it easy to upload data directly from your BaseSpace account to your One Codex account! Go to the Upload Page (click on Upload / Import from the left-hand navigation bar), and select the option for "Import from: BaseSpace".

You will first need to link your BaseSpace account to your One Codex account. Clicking the "Authorize" button will bring you to the BaseSpace login page. Login and follow the instructions to authorize the connection between BaseSpace and One Codex. You will only need to do this for the initial connection.

Once you log in with your BaseSpace credentials, you will see a list of your BaseSpace projects, and can expand to view the samples within each. We support both Samples and BioSamples, and allow you to toggle between the two, using the dropdown menu at the top-right of the table. Select the samples you wish to import (or "Select all" for a given BaseSpace project). Choose an optional One Codex project you wish to import the samples too, and click "Import".

Finally if you need to disconnect your BaseSpace account at any time, there is a button at the bottom-left of the page to do so.

Some users may wish to compare their own data with samples that are publicly available on the Sequence Read Archive (SRA), or perhaps re-analyze SRA samples using the One Codex pipeline. We've made it easier to import samples from the SRA into your account directly. You'll find this option on the Upload page.

Once you select to "Import from: SRA", you'll see the below screen. You can enter one or more accessions (comma-separated) to import at a given time. The accessions that are currently accepted will be shown below the text box.

It's not just individual samples or SRA runs that you can import. We even have an option to import an entire SRA Project. Once you enter a PRJNA accession, we will determine the number of SRA "Runs" to import as samples in the platform, so that you can confirm the project (before incurring charges).

We'll draw on the metadata on these projects and samples, both to create a corresponding project in your account, and to apply as metadata to each sample, so that you can more easily compare your samples.

Trying to import a project from which some samples were already imported, will not duplicate samples. It will only supplement the project with the missing samples.

To complement the web interface, we also provide a command line interface (CLI) and Python client library for uploading files to One Codex. These tools enable programmatic, including fully automated, uploads to One Codex.

The CLI also supports several additional features:

The command line interface is written in Python and accompanies our client library. It should be easily installable on most machines with the following command:

If you haven't previously logged in, the following command will prompt you for your username and password and then save a ~/.onecodex file with your API key.

This command will automatically upload one or more FASTQs into your account, prompting you to interleave any paired-end data if applicable (which we recommend).

More documentation for the CLI can be found here.