Installation

Prérequis, l'installation de base et l'extra optionnel du niveau compilé.

Un seul paquet vous donne tout : la CLI magiclock, le SDK hôte (bootstrap(), open_model()) et l'outillage de build pour le niveau compilé.

Prérequis

  • Python 3.9–3.14 sur macOS (Apple Silicon), Windows ou Linux.
  • Un environnement virtuel est recommandé mais pas obligatoire — le paquet s'installe dans l'interpréteur qui exécute pip install.
  • Aucun compilateur C n'est nécessaire pour le niveau pratique (chiffrement du code et des modèles). Le niveau compilé en a besoin d'un — voir ci-dessous.
  • Windows sur ARM : installez d'abord cryptography==46.0.3pip install "cryptography==46.0.3" — puis installez MagicLock. Les versions plus récentes de cryptography ne publient pas de wheel Windows ARM64, si bien que pip tenterait sinon de la compiler depuis les sources et exigerait une chaîne d'outils Rust.

Installation

shell
pip install magiclock

Vérification

shell
magiclock --version
magiclock --help

L'extra du niveau compilé

magiclock build compile votre application en binaire natif (voir Build compilé). Il repose sur un backend de build basé sur Nuitka, qui nécessite une chaîne d'outils C sur la machine de build :

shell
pip install "magiclock[build]"
PlateformeChaîne d'outils
macOSXcode Command Line Tools (xcode-select --install)
Linuxgcc/clang via le gestionnaire de paquets de votre distribution
WindowsMSVC Build Tools, ou MinGW-w64

Vous n'avez besoin de l'extra [build] et d'une chaîne d'outils que sur la machine qui exécute magiclock build — pas sur les machines qui exécuteront ensuite la sortie compilée.

Mise à niveau

shell
pip install --upgrade magiclock

Les artefacts chiffrés et les licences ne sont pas affectés par une mise à niveau de la version de la CLI/du SDK.

CI et conteneurs

L'installation est identique partout, y compris dans un conteneur ou un runner CI — rien dans l'installation elle-même ne dépend d'une interface graphique. L'activation non interactive (pour que magiclock protect n'ait pas besoin d'ouvrir un navigateur) est couverte dans Compte et activation.