Install

Requirements, the base install, and the optional compiled-tier extra.

One package gets you everything: the magiclock CLI, the host SDK (bootstrap(), open_model()), and the build tooling for the compiled tier.

Requirements

  • Python 3.9–3.14 on macOS, Windows, or Linux.
  • A virtual environment is recommended but not required — the package installs into whichever interpreter runs pip install.
  • No C compiler is needed for the convenience tier (encrypting code and models). The compiled tier does need one — see below.

Install

shell
pip install magiclock

Verify it

shell
magiclock --version
magiclock --help

The compiled-tier extra

magiclock build compiles your app to a native binary (see Compiled Build). It depends on a Nuitka-based build backend, which needs a C toolchain on the build machine:

shell
pip install "magiclock[build]"
PlatformToolchain
macOSXcode Command Line Tools (xcode-select --install)
Linuxgcc/clang from your distro's package manager
WindowsMSVC Build Tools, or MinGW-w64

You only need the [build] extra and a toolchain on the machine that runs magiclock build — not on machines that later run the compiled output.

Upgrading

shell
pip install --upgrade magiclock

Encrypted artifacts and licenses aren't affected by upgrading the CLI/SDK version.

CI and containers

Installing is the same everywhere, including inside a container or a CI runner — there's nothing GUI-dependent about the install itself. Non-interactive activation (so magiclock protect doesn't need to open a browser) is covered in Account & Activation.

PreviousOverviewNextEncrypting Code