Skip to main content

Pure python 3 module to communicate with a Helios server.

Project description

Helios Logo

Helios Client API (Pure Python 3 Module)

This is an easy to use pure Python 3 module that provides an API to communicate with a remote Helios server. You can manage your music catalogue as well as perform similarity matches. You can review the raw REST API documentation here.

What is Helios?

Helios is a powerful B2B technology to allow searching of large commercial music libraries by using music itself as the search key. There are many uses, but here are a few examples:

  • You have a commercial music library of any size. Perhaps you are a major record label, perhaps independent, or maybe you've amalgamated music from multiple labels, independent artists, or publishers. You need to assist your clients with obtaining synchronization licenses quickly for appropriate pieces of music for their film, TV, documentary, commercial, video game, or some other context.

  • Your business receives a new supply of music each month from artists. You need to be able to predict which new music is more likely to generate revenue based on how existing music in your catalogue already performed.

  • You have a digital jukebox in bars, restaurants, and pubs. You want venue patrons to be able to play more music like the music they just paid to hear.

  • You have a music catalogue management platform that publishers and labels use to track their digital assets. Your customers want to be able to search within their own catalogue using your slick platform.

  • You have an online digital music store and you'd like to be able to make intelligent product recommendations to your customers based on what songs they already have in their shopping cart before they check out.

  • You have a streaming music service for different venues or channels. You have in-house DJs that custom curate the playlists. You want to reduce their work as they create new ones.

  • You have a streaming music service. The listener asked to skip the current track, but they also never want to hear anything similar again.

  • You market software for DJs, such as plugins to manage their library. While they're performing live, a plugin in their favourite software suggests new tracks to mix or play next.

There are countless other examples, but let's talk about the first one. Nearly always, your client approaches you with samples already in hand. "Hey, do you have anything like this?" This could be an MP3 or a YouTube video URL. Because Helios allows you to search the catalogue using music itself as the search key, you could use the customer's samples directly to help them find what they're looking for.

Traditionally, in the absence of such technology, the way this has been done for decades may surprise many. It is both costly and involves many hours or even days of manual human labour which delays the business process. The business must manually search, usually using textual tags, and listen to a great deal of irrelevant music in the hopes of finding the one the client is actually willing to spend money on.

Quick installation


Packages already prepared for Ubuntu 19.04 (disco) and later are available on our Personal Package Archive (PPA) here. To get the package installed and be up and running in seconds, just run the following two commands:

$ sudo add-apt-repository ppa:kip/helios-public
$ sudo apt install python3-helios-client


If you are not using Ubuntu 19.04 or later and know what you are doing, you can use Python's ad hoc package manaement system. This is not recommended as a first choice because it is not as robust as a native package manager.

$ pip install helios-client


This Python module is released under the terms of the LGPL 3.0 or greater. Copyright (C) 2015-2021 Cartesian Theatre. See Copying for more information.

Download files

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

Files for helios-client, version 0.3.dev20210618
Filename, size File type Python version Upload date Hashes
Filename, size helios_client-0.3.dev20210618-py3-none-any.whl (13.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size helios-client-0.3.dev20210618.tar.gz (16.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page