Skip to main content
The ThinkPlatform-client package contains the tp CLI and public Python SDK. It connects to an existing ThinkPlatform service; get your deployment’s connection settings before signing in. Install the CLI and SDK from PyPI. The current release is 0.6.134.

​
Supported environments

The client is distributed as binary wheels for these environments: Intel macOS is excluded from the initial release. Public source distributions are also outside this release, so an unsupported environment cannot fall back to building the client from source.

​
Create a fresh environment

Use a separate virtual environment for the client. The examples select Python 3.13; substitute 3.11 or 3.12 if that is your supported interpreter. Bash (Linux or macOS)
PowerShell (Windows)
If PowerShell prevents activation, use .\.venv\Scripts\python.exe in place of python and .\.venv\Scripts\tp.exe in place of tp in the following commands.

​
Install the client

Install from PyPI in the activated environment:

​
Verify the installation

These commands run locally and do not require credentials:
Set up your connection and project interactively:
The wizard guides sign-in and numbered organization/project selection, then saves the profile after confirmation. See Authentication for deployment settings and Projects and profiles for manual setup and scripts.

​
Upgrade

Upgrade within your client environment:
If you previously used the full ThinkPlatform runtime package, create a fresh environment for ThinkPlatform-client. Keep your runtime environment separate rather than installing both distributions over the same package files.

​
Troubleshooting

Check python --version, your operating system, and interpreter architecture against the supported matrix. Upgrade pip in that environment and retry. Linux requires glibc 2.28+; Intel macOS and unsupported Python versions have no initial public wheel.
Activate the environment where you installed the client and rerun python -m pip show ThinkPlatform-client. The tp executable lives in that environment’s bin directory on Linux/macOS or Scripts directory on Windows. You can also invoke .venv/bin/tp or .\.venv\Scripts\tp.exe directly from the directory containing .venv.
Run installation through python -m pip after activating the environment. Check python --version and python -m pip --version to confirm the interpreter and pip location before retrying.
Create a new virtual environment and install only the client there. Verify tp --version and tp --help before configuring authentication. Avoid copying installed package files between environments.
For changes from older versions, including the Apps command split, see Upgrade and migration.