Get Help

Installation

One piece: the justcatit package from PyPI. It carries its own .NET runtime, so there is nothing else to install first.

Prerequisites

A 64-bit Python, 3.8 or later. The package depends on pythonnet, a compiled extension that is released for a range of Python versions — pip picks the pythonnet release that fits your Python; a Python newer than the latest pythonnet release cannot install the module until pythonnet catches up.

The package brings its own .NET runtime — an installed .NET is not used. pip picks the wheel built for your platform automatically; there is a wheel per platform (see Platforms), so a mismatched platform is refused by pip up front rather than failing on the first function call.

On Linux and macOS, a minimal container image needs ICU (libicu) installed — desktop distributions already have it.

Some data source providers need additional software installed on the machine. The requirement belongs to the provider, not to the module — each provider page states what it needs, and the Providers overview marks which providers need a driver.

Install 

pip install justcatit

(python3 -m pip install justcatit on Linux/macOS, or py -m pip install justcatit on Windows when pip is not on PATH.) The package is large — it carries the CAT engine, the native database libraries and the .NET runtime — so the first install takes a moment. Pin the version in automated processes: pip install justcatit==3.0.0.

Verify the installation 

from justcatit import cat
print(cat.get_instance())

get_instance needs neither a token nor a key; it prints the instance (versions, platform, whether a key is set) and proves the .NET runtime was found.

Update 

pip install --upgrade justcatit

Uninstall 

pip uninstall justcatit

Uninstalling removes the package only. Project files, test definitions and results stay where they are; the license key and instance identity stay in %APPDATA%\CAT\ (~/.config/CAT/ on Linux/macOS) for the other CAT tools.

← Introduction
close_project →