Skip to content

Troubleshooting#

Python Version Check#

Ensure that you have Python 3.10 or above installed. To verify your Python version, open a terminal and type:

python --version

If your Python version is outdated, follow the instructions on the official Python documentation to update it.

Engine AI SDK Installation Check#

To verify that the Engine AI SDK is installed correctly, run the following command in your terminal:

engineai --version

Expected output:

EngineAI's Platform SDK v0.135.0

Note: If the command is not recognized, ensure the SDK is properly installed and added to your system PATH. To check if engineai is in your PATH, use:

which engineai

In case the SDK is not installed or needs an upgrade, refer to the installation guide.

If you encounter import errors, make sure you're using the correct Python environment where the SDK is installed. You can check your active Python environment by running: 

which python

Permissions Issues#

If you encounter issues publishing dashboards or executing CLI commands, the problem may be related to your user permissions. There are two main types of permissions in Engine AI:

Workspace Permissions#

Your role within a workspace (Owner, Admin, or Member) determines your access and modification rights across the entire workspace, including apps, dashboards, users, and workspace settings.

App-Specific Permissions#

Each app has its own permission levels (Manager, Writer, Reader) that control what you can do within that specific app.

For detailed information about permissions and how they work, please refer to our management portal documentation:

Note: If you believe you should have access to something but are encountering permission errors, please contact your workspace administrator or reach out to our support team.

Dashboard Widget Errors#

If you're experiencing issues with dashboard widgets not functioning as expected or data not loading properly, you can use the debug mode in the version preview to inspect widget-level logs and identify errors or warnings.

To troubleshoot widget issues:

  1. Navigate to your dashboard's management page.
  2. Preview the problematic version.
  3. Enable debug mode to view detailed logs for each widget.

For detailed instructions on using debug mode, see the Debug Mode in Version Preview documentation.

Talk to Our Support#

If you’re still having issues, please reach out to our team for support at support@engineai.com.