Getting Started

Choose the ChemApp for Python wheel that matches your computer and Python version. On both Windows and Linux you can install it in a project-specific virtual environment with uv, or directly into an existing Python installation with pip.

Choose a Wheel

Obtain the wheel (.whl) for your edition from GTT Technologies. Development wheels start with chemapp- and Light wheels start with chemapplight-. The file must be obtained directly from GTT Technologies. It is not available by any other means. For example, in chemapp-836.0.1-cp312-cp312-win_amd64.whl, 836.0.1 is the package version. The pair cp312-cp312 requires standard CPython 3.12 and works across its patch releases.

The last part of the filename gives the platform requirements.

Platform tag

Where to use it

win_amd64

Windows with 64-bit x86 Python (Intel or AMD).

manylinux_2_34_x86_64

64-bit x86 Linux with glibc 2.34 or newer. On a glibc system, getconf GNU_LIBC_VERSION shows the installed version.

linux_x86_64

64-bit x86 Linux. The minimum glibc version and other shared-library requirements depend on the build. Check the requirements supplied with your wheel.

On Linux, uname -m should print x86_64 for these wheels. A virtual environment uses the host’s system libraries, so the Linux requirements apply to both installation methods. If installation succeeds but importing ChemApp reports a missing .so or GLIBC version, check the library named in the error against the wheel’s requirements.

Install the Wheel

Save the wheel in your project folder and open PowerShell (Windows) or a terminal (Linux) in that folder. Choose one of the two methods below. Both install the wheel and its Python dependencies.

The examples use a Light wheel for CPython 3.12. Substitute your wheel’s full filename and Python version. For a Development wheel, change from chemapplight import basic to from chemapp import basic in the final command. It prints the path of the loaded ChemApp module (.pyd on Windows or .so on Linux).

With uv in a virtual environment

Install uv for your operating system using the uv installation instructions. The first command creates a virtual environment named .venv in your project folder. uv can download the matching Python version if needed. The remaining commands use that environment directly without activating it.

Windows (PowerShell)

uv venv --python 3.12
uv pip install --python .venv .\chemapplight-837.0.0-cp312-cp312-win_amd64.whl
.\.venv\Scripts\python.exe -c "from chemapplight import basic; print(basic.__file__)"

Linux

uv venv --python 3.12
uv pip install --python .venv ./chemapplight-837.0.0-cp312-cp312-manylinux_2_34_x86_64.whl
.venv/bin/python -c "from chemapplight import basic; print(basic.__file__)"

Use that same Python executable to run your scripts or select it as the interpreter in your editor.

With pip in an existing Python installation

Use this method if you manage your own Python installation and want ChemApp available to other scripts that use it. Choose a 64-bit CPython interpreter that matches your wheel and has pip installed. On Windows you can obtain Python from the Python downloads page.

Run pip through that interpreter. The --user option installs the packages for your account. These examples use the CPython 3.12 Light wheels.

Windows (PowerShell)

py -3.12 -m pip install --user .\chemapplight-837.0.0-cp312-cp312-win_amd64.whl
py -3.12 -c "from chemapplight import basic; print(basic.__file__)"

Linux

python3.12 -m pip install --user ./chemapplight-837.0.0-cp312-cp312-manylinux_2_34_x86_64.whl
python3.12 -c "from chemapplight import basic; print(basic.__file__)"

If pip reports externally-managed-environment, your Linux distribution manages that Python installation. Use the uv method or choose a separate Python installation that you manage.

Importing ChemApp for Python Components

Use the package name from the wheel you installed in your Python scripts. Wheels whose names start with chemapp- use chemapp. Wheels whose names start with chemapplight- use chemapplight. Substitute your package name in the following imports.

from chemapp import core
from chemapp import basic
from chemapp import friendly

If you prefer shorter names, import the modules with aliases.

from chemapp import core as cac
from chemapp import basic as cab
from chemapp import friendly as caf

Getting Help

Start the Python interpreter where you installed ChemApp. For a uv environment named .venv, run .\.venv\Scripts\python.exe on Windows or .venv/bin/python on Linux from the project directory. For a direct installation, start the interpreter you used with -m pip.

At the Python prompt, use help() to read about a module or a single function. Use chemapp or chemapplight according to your wheel.

>>> from chemapp import basic, core, friendly
>>> help(core)
>>> help(friendly)
>>> help(basic.tqce)