Documentation
Technical documentation for installing, configuring, and running the Pyvorin compiler.
Auth Login Flow
The web-based login flow connects the CLI to your Portal account without typing your password into the terminal. Run pyvorin auth login.The CLI prints a short device code and a URL.Open the URL in a browser, sign in, and enter the code.Approve the device in the Portal.The CLI receives and stores a device token. Device codes expire after 10 minutes. If the code expires, run the command again to generate a new one.
Updated 1 month ago
Licence Key Activation
Licence keys link the CLI to a subscription and control how many devices can compile. pyvorin auth activate --key PYV-XXXX-XXXX-XXXX The CLI sends the key to the Portal along with your device token. If the key is valid and the device limit has not been reached, the CLI receives a long-lived licence device token. Find your licence keys on the Licence Keys page in the Portal. Keys are masked by default; use the reveal action when activating a new device.
Updated 1 month ago
Token Refresh
Licence device tokens can be refreshed without repeating the full activation flow. pyvorin auth refresh This contacts the Portal and exchanges the current token for a fresh one. Refresh is automatic in most cases, but you can run it manually if you see authentication errors.
Updated 1 month ago
Auth Status
Check your current authentication state at any time. pyvorin auth status The output shows your account email, device identifier, licence key label, expiry, and device limit usage. Use this output when opening support tickets.
Updated 1 month ago
Revoking Devices
Revoking a device removes its access to your licence. This is useful when you replace hardware or deactivate a CI runner. Open the Licences page in the Portal.Select the licence key.Find the device in the active devices list.Click Revoke. The device token becomes invalid immediately. The CLI on that device must re-authenticate before it can compile again.
Updated 1 month ago
Two-Factor Authentication
Two-factor authentication (2FA) adds an extra layer of security to your Portal account. Enable 2FA from the Security page. You will need an authenticator app that supports TOTP. After setup, sign-in attempts require both your password and a time-based code. Keep your recovery codes in a safe place. If you lose access to your authenticator, you will need them to recover your account.
Updated 1 month ago