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.3—pip 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
pip install magiclockVérification
magiclock --version
magiclock --helpL'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 :
pip install "magiclock[build]"| Plateforme | Chaîne d'outils |
|---|---|
| macOS | Xcode Command Line Tools (xcode-select --install) |
| Linux | gcc/clang via le gestionnaire de paquets de votre distribution |
| Windows | MSVC 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
pip install --upgrade magiclockLes 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.