Skip to main content

A Python client for the Clinical Variant Ark

Project description


pyark is a python client to the Clinical Variant Ark (CVA) REST API pyark primary aim is to facilitate access to CVA knowledge base hiding the complexity using the REST API. Also by integrating with major Python data analysis libraries it aims at enabling an analytical framework on CVA.

Getting Started


pyark works with python 2.7 up to python 3.6.


Install with pip:

pip install clinical-variant-ark

You will need a CVA server up and running and you will need credentials with the right authorisation permissions.

Initialise the client:

from pyark.cva_client import CvaClient

cva = CvaClient(url_base="https://your.cva", user="you", password="your_secret")
cases_client = cva.cases()
pedigrees_client = cva.pedigrees()
entities_client = cva.entities()
variants_client = cva.variants()
report_events_client = cva.report_events()
transactions_client = cva.transactions()

Query CVA's knowledge base:


Check the version of the client you are using:

import pyark

print("pyark version {}".format(pyark.VERSION))

See the documentation for further usage at

Running the tests

Set the following environment variables:

export CVA_URL_BASE="https://your.cva"
export CVA_USER="you"
export CVA_PASSWORD="your_secret"

Then run unit tests:

python -m unittest discover

These tests rely on a working CVA server with some data in it.


We use semantic versioning. The major and minor versions are aligned with the CVA backend versioning.


See also the list of contributors who participated in this project.


This project is licensed under the Apache v2.0 license - see the file for details


  • Genomics England bioinformatics team as an infinite source of requirements
  • Katherine Smith and Augusto Rendon for spending their time playing with pyark!
  • Antonio Rueda Martin for listening to us

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 clinical-variant-ark, version 4.1.3
Filename, size File type Python version Upload date Hashes
Filename, size clinical-variant-ark-4.1.3.tar.gz (16.8 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