Infermedica Python client provides access to a medical diagnostic API created by Infermedica. The API documentation can be found at Infermedica Developer Portal.

Install using pip:

$ pip install infermedica-api

or using easy_install:

$ easy_install infermedica-api

First of all register for a developer account and obtain your app_id and app_key at Infermedica Developer Portal.

Configure a global API object to easily use it everywhere:

import infermedica_api

infermedica_api.configure(app_id='YOUR_APP_ID', app_key='YOUR_APP_KEY')

... and then in any module just import infermedica module and get configured API object:

import infermedica_api

api = infermedica_api.get_api()

Configure through a non-global API object:

import infermedica_api
api = infermedica_api.API(app_id='YOUR_APP_ID', app_key='YOUR_APP_KEY')

print(api.info())

Here is an example of how to use the API to get a list of patient's likely diagnoses.

import infermedica_api

api = infermedica_api.get_api()

# Create diagnosis object with initial patient information.
# Note that time argument is optional here as well as in the add_observation function
request = infermedica_api.Diagnosis(sex='male', age=35, time='2015-02-09T08:30:00+05:00')

request.add_observation('s_102', 'present', time='2015-02-09T08:00:00+05:00')
request.add_observation('s_21', 'present', time='2015-02-09')
request.add_observation('s_98', 'absent')

request.set_pursued_conditions(['c_76', 'c_9'])  # Optional

# call diagnosis
request = api.diagnosis(request)

print(request)

Note that after each diagnosis call, the request object gets updated and you can obtain a diagnostic question to ask. You can also update the request object with new observations or risk factors to get even more precise diagnostic insights and new questions to verify.

For more take a look at provided examples.

To easily run examples edit examples/config.py file and enter your account credentials. Then go to examples folder and just run the following:

$ python observations.py

$ python risk_factors.py

$ python conditions.py

$ python diagnosis.py

Arkadiusz Szydełko (akszydelko) and Paweł Iwaszko (iwaszko) are the creators and current maintainers of the Infermedica API Python client.

Pull requests are always welcome. Before submitting a pull request, please ensure that your coding style follows PEP 8 and rules form .editorconfig file.

Copyright 2015 by Infermedica.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0