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, please contact us:

This function is currently not optimized: <function name>. Additionally, an internal error occured when defaulting to a non-optimized version.

This error means that Terality has not implemented (yet) an optimized version of the function you are trying to call. In such cases, we default to the pandas implementation. When this default implementation also raises an exception, you get the error message above.
We actively monitor such cases, and prioritize implementing optimized pandas functions based on observed usage. We also add specialized error messages for common cases.
In the meantime, you can:
    try another function with a similar role. For instance, many usages of pd.DataFrame.apply can be replaced with specialized functions.
    call to_pandas() on your Terality DataFrame or Series (df.to_pandas() or series.to_pandas()) to get back a local pandas structure. From here, you can proceed with the pandas library as usual.
    contact our support to discuss and help us prioritize your use case:

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:
Last modified 29d ago