Installation and Setup

Capsa is designed to integrate seamlessly into your existing workflows, reusing your existing models. To accomplish this we provide two versions of capsa, capsa-torch (for PyTorch models) and capsa-tf (for TensorFlow models).

Installation

Warning

Capsa wheels are only available on linux, amd64, CPython 3.8 - 3.11

If you would like to use Capsa in other environments, please let us know by contacting us at help@themisai.io.

capsa_torch can be installed using pip:

pip install --index-url https://pypi.themisai.io capsa-torch

Minimum torch version: 2.1.0

capsa_tf can be installed using pip:

pip install --index-url https://pypi.themisai.io capsa-tf

Minimum tensorflow version: 2.12.0

License Activation

After installing the package, it will need to be activated. This needs to be done once per device. To activate call:

themis activate LICENSE_KEY

where LICENSE_KEY is your Themis AI license key.

Cloud License

If you are using a cloud-style license you will need to keep the themis activate command running while you use Capsa. The simplest way to do so is to run

themis activate LICENSE_KEY &

Then press ENTER and run disown. This will start the process and move it into the background. To stop the process at any time run themis deactivate. Alternatively, if you prefer, you can manage the process yourself using tmux, screen or similar tools.

Note

After running themis activate LICENSE_KEY, on subsequent calls you can omit the LICENSE_KEY argument and just call themis activate

Check your License

To confirm that your Capsa license is activated, run

themis check