Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

EGA python client

Project description

EGA python client - pyEGA3
pyEGA3 uses the EGA REST API to download authorized datasets and files

Currently works only with Python3

Python "requests" module
pip3 install requests

Firewall Ports
This client makes https calls to the EGA AAI ( and to the EGA Data API ( Both ports 8443 and 8051 must be reachable from the location where this client script is run. Otherwise you will experience timeouts.
(e.g., should not time out).
sudo pip3 install pyega3
INSTALLATION via Conda(Bioconda channel):
conda config --add channels bioconda
conda config --add channels conda-forge
conda install pyega3
pyega3 [-h] [-d] -cf CREDENTIALS_FILE [-c CONNECTIONS] {datasets,files,fetch} ...

Download from EMBL EBI's EGA (European Genome-phenome Archive)

positional arguments:
datasets List authorized datasets
files List files in a specified dataset
fetch Fetch a dataset or file

optional arguments:
-h, --help show this help message and exit
-d, --debug Extra debugging messages
JSON file containing credentials
Download using specified number of connections


For reference there is a test CREDENTIALS_FILE provided here in 'credential_file.json'

Your username and password are provided to you by EGA.


Parallelism ( download via multiple connections ) works on the file level,
but still usable while downloading whole dataset.
If -c command line switch is provided all big files (>100Mb) in the
dataset will be downloaded using specified # of connections.

The number of connections breaks down individual file downloads into segments,
which are then downloaded in parallel. So using a very high number actually
introduces overhead that slows down the download of the file.
Files are still downloaded in sequence – so multiple connections doesn't mean
downloading multiple files in parallel, if an entire dataset is being downloaded.


GENOMIC RANGE REQUESTS ( via Htsget protocol ) :

usage: pyega3 fetch [-h] [--reference-name REFERENCE_NAME]
[--reference-md5 REFERENCE_MD5] [--start START]
[--end END] [--format {BAM,CRAM}] [--saveto [SAVETO]]

positional arguments:
identifier Id for dataset (e.g. EGAD00000000001) or file (e.g.

optional arguments:
-h, --help show this help message and exit
The reference sequence name, for example 'chr1', '1',
or 'chrX'. If unspecified, all data is returned.
--reference-md5 REFERENCE_MD5, -m REFERENCE_MD5
The MD5 checksum uniquely representing the requested
reference sequence as a lower-case hexadecimal string,
calculated as the MD5 of the upper-case sequence
excluding all whitespace characters.
--start START, -s START
The start position of the range on the reference,
0-based, inclusive. If specified, reference-name or
reference-md5 must also be specified.
--end END, -e END The end position of the range on the reference,
0-based exclusive. If specified, reference-name or
reference-md5 must also be specified.
--format {BAM,CRAM}, -f {BAM,CRAM}
The format of data to request.
The maximum number of times to retry a failed
transfer. Any negative number means infinite number of
retries( default value = 5 ).
--retry-wait RETRY_WAIT, -W RETRY_WAIT
The number of seconds to wait before retrying a failed
transfer( default value = 5 ).
--saveto [SAVETO] Output file(for files)/output dir(for datasets)

How to debug and provide the output to the EGA Helpdesk team?

When attempting your download always make sure that you are using the most up-to-date version of the Python Client, which can be always found on the current page.

We encourage our users facing download failures to contact us here on Helpdesk ( In order to expedite the trouble shooting process we would need the output from your debug attempts. Examples of which are detailed below -

Users facing access issues

nohup pyega3 -d -cf /Path/To/CREDENTIAL_FILE datasets > /Path/To/Output.txt

Users facing issues listing the files in a dataset
pyega3 -d -cf /Path/To/CREDENTIAL_FILE files EGAD00000000000

Users facing download issues
1.Make sure you have access to the dataset/s you are trying to download using the following command

pyega3 -cf /Path/To/CREDENTIAL_FILE datasets

2.Try to list out the files in the dataset of interest using the following command.

pyega3 -d -cf /Path/To/CREDENTIAL_FILE files EGAD00000000000

The output of which will also provide you with the file size. It is recommended that you select a file of small size for the next step

3.Finally, please try and pull down this file using the debug mode.

pyega3 -d -cf /Path/To/CREDENTIAL_FILE fetch EGAF00000000000

The debug flag (-d) will generate a log which can be forwarded to our Helpdesk members. The contents of the debug output will provide us with more clues to the state of your downloads and are needed to query the errors and return codes that your attempts will receive.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyega3, version 3.0.40
Filename, size File type Python version Upload date Hashes
Filename, size pyega3-3.0.40.tar.gz (17.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page