Troubleshooting

This page lists common problems and how to resolve them.

CLI cannot connect

• Verify internet access: curl https://crm.pyvorin.com/health.
• Check proxy settings; the CLI respects HTTP_PROXY and HTTPS_PROXY.
• Run pyvorin doctor for a structured diagnosis.

Licence activation fails

• Confirm the key is typed correctly.
• Check the device limit on the Portal Licences page.
• Revoke unused devices if you have reached the limit.
• Ensure the key has not expired.

Compilation fails

• Run with --verbose to see the failing module.
• Switch to --mode=safe to allow more fallbacks.
• Check that all dependencies are installed in the active virtual environment.
• Review compiler errors in the Portal Usage page.

Low native coverage

• Use the fallback report to identify constructs to refactor.
• Add type hints and avoid dynamic types.
• Whitelist supported extensions in native.extensions.

Credits not updating

• Credits refresh with the billing cycle.
• Successful compiles deduct 1 credit; errors do not.
• Check the Portal Usage page for details.

Still blocked?

Open a support ticket from the Portal after signing in. Include the output of pyvorin doctor and any fallback or error reports.