Troubleshooting common issues
This page lists commonly encountered issues and possible resolutions.

UnconfiguredTeralityClientError: The Terality client is not configured.

The Terality client could not find the Terality configuration and credentials on this machine.
If you don't have a Terality account yet, follow the guide to get started with a free account:
If you already have a Terality account, you can configure the client with the Terality command line interface (CLI):
terality account configure
More info on the CLI here:
If you already have a Terality account and lost your API key, you can generate a new one on the user dashboard at
Don't hesitate to contact us if you need further guidance about your account:

bash: terality: command not found

You can see this message while trying to run the Terality CLI in a terminal (such as when running terality account create). It means that the Terality CLI is not correctly installed in your current Python environment.
First, ensure that terality is correctly installed in the current Python environment: in the same terminal, run pip install --upgrade --force-reinstall terality and retry.
If that doesn't solve the issue, check that the previous command does not output any warning looking like
WARNING: The script terality is installed in /Users/<you>/Library/Python/3.7/bin which is not on PATH.
If you see this warning, you have two solutions:

You are using version x.y.z of the Terality client, but version a.b.c is available. Consider upgrading your version to get the latest fixes and features.

Terality frequently releases new client versions that include important fixes. We recommend always using the latest version of the client. In some cases, upgrading the client may solve an error you're encountering.
The method to upgrade the client depends on how you installed it.
If you used pip , you can upgrade the client with the following procedure:
  1. 1.
    run the command below in a terminal:
pip install --upgrade terality
2. restart the Python interpreter or notebook kernel.
If you are using Python virtual environment, you need to run the upgrade command in the same virtual environment that's hosting the Python interpreter or notebook.
More details here:
Last modified 15d ago