<div align="center"> <img src="/tools/data/gh_images/logo.png" alt="drawing" width="100"/>

Libra

An ergonomic machine learning library for non-technical users. Save time. Blaze through ML.

</div>

Check out our newer machine learning tool Nylon!

Installation

Install latest release version:

pip install -U libra

Install directory from github:

git clone https://github.com/Palashio/libra.git
cd libra
pip install .

Alternatively you can build and use the docker image locally with:

docker build . -f docker/libra-normal/Dockerfile -t libra
docker run -v /path/to/my/data:/data -it --rm libra

Or if you have nvidia-docker installed.

docker build . -f docker/libra-gpu/Dockerfile -t libra-gpu
docker run -v /path/to/my/data:/data --gpus all -it --rm libra-gpu

Usage: the basics

The core functionality of libra works through the client object. A new client object should be created for every dataset that you want to produce results for. All information about the models that're built, the plots that are generated, and the metrics are created will be stored in the object.

You can then call different queries on that client object, and the dataset you passed to it will be used.

pythonCopy
from libra import client

newClient = client('path/to/dataset') 
newClient.neural_network_query('please model the median number of households')

Now, calling

pythonCopy
newClient.info()

will return a dictionary of all the information that was generated:

pythonCopy
dict_keys(['id', 'model', 'num_classes', 'plots', 'target', 'preprocessor', 
          'interpreter', 'test_data', 'losses', 'accuracy'])

Other queries can also be called on the same object, and will be appended to the models dictionary.

pythonCopy
newClient.svm_query('predict the proximity to the ocean')
newClient.model().keys()

dict_keys(['regression_ANN', svm'])

Tutorials

• Full documentation can be found at libradocs.org.
• A list of resources can be found on our awesome-libra repository.

---

Asking for help

Welcome to the Libra community!

If you have any questions, feel free to:

1. read the docs.
2. Search through the issues.
3. Ask on stackoverflow with the tag libra.
4. Join our slack.

Demos

Contact

Shoot me an email at ps9cmk@virginia.edu if you'd like to get in touch!

Follow me on twitter for updates and my insights about modern AI!