HolocronToolset

A PyQt/PySide application that can edit the files used by the KotOR game engine.

Requirements

Python 3.8+
qtpy (abstraction layer for pyqt5/6 and pyside2/6)
(Optional) A KotOR I or II game installed on your machine somewhere.

Local Run

With uv (from PyKotor repo root):

# End users (latest from PyPI)
uvx --refresh holocrontoolset

# Developers (local source)
uvx --with-editable Libraries/PyKotor --with-editable Tools/HolocronToolset holocrontoolset
uv run --directory Tools/HolocronToolset/src --module toolset

Without uv (activated venv, from Tools/HolocronToolset):

Windows

python -m pip install -r requirements.txt
$env:PYTHONPATH = (Get-Location).Path
python toolset/__main__.py

Unix

python3 -m pip install -r requirements.txt
PYTHONPATH=$PWD python3 toolset/__main__.py

Note for Alpine users:

You might get this error:

pyproject.toml: line 7: using '[tool.sip.metadata]' to specify the project metadata is deprecated and will be removed in SIP v7.0.0, use '[project]' instead

While we're not sure what the exact problem is, it seems newer python versions won't correctly be able to build pyqt5. If you don't have a binary available (--only-binary=:all: returns no versions) you'll need to downgrade python preferably to 3.8 or you won't be able to use qt5! See this issue for more information

Local Development

Clone PyKotor. Use uvx --with-editable to run from local source, or run install_python_venv.ps1 for a traditional venv setup.

Accessing the GUI Designer

python -m pip install qt5-applications

Then navigate to your Python's site-packages folder:

python -m site --user-site

Then navigate to ./site-packages/qt5_applications/Qt/bin and open the designer.exe file.

Metadata

Release files for holocrontoolset 4.0.0b31

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for holocrontoolset 4.0.0b31
File	Size	Uploaded	Provenance
holocrontoolset-4.0.0b31.tar.gz	2.3 MB	May 2, 2026	Without provenance	Details

Release files / holocrontoolset-4.0.0b31.tar.gz

Download URL	holocrontoolset-4.0.0b31.tar.gz
Size	2.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`94088d10cc51a110e8615983ad58b6228084b2a6c48ce7fdadda84baa9576e61`
BLAKE2b-256 checksum How to use checksums	`3c3bc321046a66e650f2611ea7e1e09eb260d31b3614939f9460f28137811377`
Upload date	May 2, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Security for holocrontoolset 4.0.0b31

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.