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 |
|---|---|
|
Windows with 64-bit x86 Python (Intel or AMD). |
|
64-bit x86 Linux with glibc 2.34 or newer. On a glibc system,
|
|
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)