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.