Skip to main content

The GNU Health GTK client

Project description

The GTK client allows to connect to the GNU Health HMIS component server from the desktop.


You can install the GNU Health HMIS client via pip:

$ pip3 install --user --upgrade gnuhealth-client


The GNU Health HMIS client is a Python application that derives from the Tryton GTK client, with specific features of GNU Health and healthcare sector.

The default profile

The GNU Health client comes with a pre-defined profile, which points to the GNU Health community demo server:

Server :
Port : 8000
User : admin
Passwd : gnusolidario

GNU Health Plugins

You can download GNU Health plugins for specific functionality.

For example:

  • The GNU Health Crypto plugin to digitally sign documents using GNUPG

  • The GNU Health Camera to use cameras and store them directly on the system (person registration, histological samples, etc..)

  • The Federation Record Locator, that communicates with thalamus and interacts with the GNU Health Information System and Person Master Index.

More information about the GNU Health plugins at :

The GNU Health client configuration file

The default configuration file resides in:


Using a custom greeter / banner

You can customize the login greeter banner to fit your institution.

In the section [client] include the banner param with the absolute path of the png file.

Something like:

banner = /home/yourlogin/myhospitalbanner.png

The default resolution of the banner is 500 x 128 pixels. Adjust yours to approximately this size.


The development of the GNU Health client will be done on GNU Savannah, using the Mercurial repository.

Tasks, bugs and mailing lists will be on , for development.

General questions can be done on mailing list.



The GNU Health GTK documentation will be at the corresponding chapter in the GNU Health Wikibook

Project details

Download files

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

Source Distribution

gnuhealth-client-4.2.0.tar.gz (714.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page