LogoLogo
  • Overview
  • publisher
    • Introduction
    • Getting Started
      • Logging in to Publisher
    • Data Sources
      • Connecting a Data Source
      • Managing a Data Source
      • Connectors
        • AWS S3 Permissions
        • Connecting to AWS S3 Storage
        • Google Cloud Storage (GCS) Permissions
        • Connecting to Google Cloud Storage
        • PostgreSQL Permissions
        • Connecting to PostgreSQL
        • PostgreSQL on Azure Permissions
        • Microsoft Azure Blob Storage Permissions
        • Connecting to Microsoft Azure Blob Storage
        • Connecting to HTTPS
        • Connecting to other sources via Trino
          • BigQuery
    • Collections
      • Creating a Collection
      • Sharing a Collection
      • Collection Filters
      • Editing Collection Metadata
      • Updating Collection Contents
    • Access Policies
      • Creating an Access Policy
      • Managing Access Policies
    • Questions
      • Adding Questions
      • Example Question
    • Settings
      • Viewing Current and Past Administrators
      • Adding an Administrator
      • Removing an Administrator
      • Setting Notification Preferences
  • Explorer
    • Introduction
    • Viewing a Collection
    • Browsing Collections
    • Asking Questions
    • Accessing a Private Collection
      • Requesting Access to a Private Collection
    • Filtering Data in Tables
      • Strings
      • Dates
      • Numbers
  • Workbench
    • Introduction
    • Getting Started
      • Logging into Workbench
      • Connecting an Engine
      • Finding or Importing a Workflow
      • Configuring Workflow Inputs
      • Running and Monitoring a Workflow
      • Locating Outputs
    • Engines
      • Adding and Updating an Engine
        • On AWS HealthOmics
        • On Microsoft Azure
        • On Google Cloud Platform
        • On Premises
      • Parameters
        • AWS HealthOmics
        • Google Cloud Platform
        • Microsoft Azure
        • On-Premises
        • Cromwell
        • Amazon Genomics CLI
    • Workflows
      • Finding Workflows
      • Adding a Workflow
      • Supported Languages
      • Repositories
        • Dockstore
    • Instruments
      • Getting Started with Instruments
      • Connecting a Storage Account
      • Using Sample Data in a Workflow
      • Running Workflows Using Samples
      • Family Based Analysis with Pedigree Information
      • Monitor the Workflow
      • CLI Reference
        • Instruments
        • Storage
        • Samples
        • OpenAPI Specification
    • Entities
    • Terminology
  • Passport
    • Introduction
    • Registering an Email Address for a Google Identity
  • Command Line Interface
    • Installation
    • Usage Examples
    • Working with JSON Data
    • Reference
      • workbench
        • runs submit
        • runs list
        • runs describe
        • runs cancel
        • runs delete
        • runs logs
        • runs tasks list
        • runs events list
        • engines list
        • engines describe
        • engines parameters list
        • engines parameters describe
        • engines health-checks list
        • workflows create
        • workflows list
        • workflows describe
        • workflows update
        • workflows delete
        • workflows versions create
        • workflows versions list
        • workflows versions describe
        • workflows versions files
        • workflows versions update
        • workflows versions delete
        • workflows versions defaults create
        • workflows versions defaults list
        • workflows versions defaults describe
        • workflows versions defaults update
        • workflows versions defaults delete
        • namespaces get-default
        • storage add
        • storage delete
        • storage describe
        • storage list
        • storage update
        • storage platforms add
        • storage platforms delete
        • storage platforms describe
        • storage platforms list
        • samples list
        • samples describe
        • samples files list
      • publisher
        • datasources list
  • Analysis
    • Python Library
    • Popular Environments
      • Cromwell
      • CWL Tool
      • Terra
      • Nextflow
      • DNAnexus
Powered by GitBook

© DNAstack. All rights reserved.

On this page
  • Installing Python
  • MacOs
  • Linux - Debian
  • Linux - CentOS, RHEL
  • Windows 10/11
  • Installing the CLI/library package
  • Windows 10/11
  • MacOS / Linux
  • Enabling Shell Completion (Optional)
  • Bash
  • Zsh
  • Fish
  • Installing from Source

Was this helpful?

  1. Command Line Interface

Installation

PreviousRegistering an Email Address for a Google IdentityNextUsage Examples

Last updated 2 months ago

Was this helpful?

DNAstack products can be accessed programmatically through the Command Line Interface (CLI) for Windows, Mac, and Linux environments.

This guide will help you install dnastack-client-library 3.0. If you need to install a specific version, please check out the list of available versions on the .

Installing Python

First, you need to have:

  • Python 3.9 or newer

  • Optional: pip 21.3 or newer. This is only required for ARM-based systems e.g., ARM-based MacOS machines..

MacOs

Newer versions of MaxOS are already bundled with Python3. To determine if you have the correct version of python installed open a terminal and type python --version. If it is already installed you will see the version printed to the console

$ python --version

Linux - Debian

If you are using a debian system (ie Ubuntu) the easiest way to install python is using the bundled apt package manager.

sudo apt update
sudo apt install -y python3 python3-pip

You can validate this has run properly in a terminal after:

python --version

Linux - CentOS, RHEL

If you are using a CentOs the easiest way to install python is using the bundled yum package manager.

sudo yum update
sudo yum install -y python3 python3-pip

You can validate this has run properly in a terminal after:

$ python --version

Windows 10/11

  1. Run the installer to install Python 3

Installing the CLI/library package

Windows 10/11

Open the Anaconda Powershell Prompt from the start menu or Anaconda Navigator and type the following

pip3 install -U dnastack-client-library
omics --version

MacOS / Linux

Open a terminal window and type the following:

pip3 install -U dnastack-client-library
omics --version

Enabling Shell Completion (Optional)

You can enable command auto-completion for the omics CLI to make it easier to use. The steps vary depending on your shell:

Bash

Add this to your ~/.bashrc:

eval "$(_OMICS_COMPLETE=bash_source omics)"

Zsh

Add this to your ~/.zshrc:

eval "$(_OMICS_COMPLETE=zsh_source omics)"

Fish

Add this to your ~/.config/fish/completions/omics.fish:

eval (env _OMICS_COMPLETE=fish_source omics)

After adding the appropriate line, either restart your shell or run:

source ~/.bashrc  # for bash
source ~/.zshrc   # for zsh
source ~/.config/fish/completions/omics.fish  # for fish

Now you can use tab completion with the omics command to auto-complete subcommands and options.

Installing from Source

First download the source code from the public Git Repository

git clone https://github.com/DNAstack/dnastack-client.git

Once the git repository is downloaded, you can build it with pip. Building the package will download all of the required dependencies and make the omics and dnastack commands available from the command line

cd dnastack-client
pip3 install -IU .

Download the installer from .

release history page
anaconda.com