Skip to content
Switch branches/tags
Go to file
This branch is 62 commits ahead of tobiasgass:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This library implements a client for the REST API of the virtualskeleton framework which is used by the Sicasl Medical Image Repository ( It supports authentication, general queries, and specific requests such as image upload/download, object linking and right management. Examples are provided in the examples directory. Please use '' for testing purposes.

Module documentation


What is in this Fork

  • Pyhton 3
  • usage of requests package instead of urllib2
  • usage of pathlib instead of os.path
  • usage of PyJWT for authentication PyJWT
  • introduction of API classes using jsonmodels

Recent updates

moved to jsonmodels for apiclasses

What is this repository for?

  • Quick summary: connect to vsd
  • Version: 0.8.1dev

How do I get set up?

  1. clone the repo

    git clone

  2. Install the package with dependencies

pip install vsdConnect


python install

or, if you want to edit the source:

pip install --editable vsdConnect

Contribution guidelines

  • Write exception handling
  • Writing tests
  • Code review
  • Adding sockets/timeouts/retries
  • Adding more stable support for pagination
  • Add general file upload
  • Write some sort of GUI example

Who do I talk to?

  • Repo owner or admin
  • Other community or team contact


  • The server response is very slow if you have 50+ folders. VSD-connect makes a request to the server for each folder. Therefore, I will be slow if you have a lot of folders and use the folder methods. You should then use the getRequest function and create your APIFolder object locally.

Get Started

This code connects to the demo server and retrieves an object

from vsdConnect import connect
from vsdConnect import models

## Connect to
api = connect.VSDConnecter()

# an available object id from the demo and define the selfurl
vsd_id = 38
selfUrl = '{0}' . format(vsd_id)

# create the APIObject and get it from the server
obj  = models.APIObject(selfUrl=selfUrl).get(api)

# display the object infos (json)

to download the object's file add this line


A python library to use the REST interface of the Virtual Skeleton Database




No releases published


No packages published