Knowledgebase
Help articles for accounts, billing, licences, and common compiler questions.
Compiler Errors Explained
Compiler errors are reported by the CLI and sent to the Portal as telemetry events. Finding error detailspyvorin compile app.py --verboseThe verbose output includes the error code, message, and module where the error occurred. Common compiler error codesCOMPILER_001 — internal compiler error. Update Pyvorin and retry.COMPILER_002 — unsupported syntax construct. Check the fallback report.COMPILER_003 — missing dependency. Install the package in the active environment. Reporting an errorpyvorin report-bug --title "Compiler error" --logsThis opens a support ticket with redacted logs and error metadata.
Updated 1 month ago
COMPILER_001
COMPILER_001 indicates an internal compiler error. First, update Pyvorin to the latest version. If the error persists, run the compile with --verbose and open a support ticket with the output. This error does not deduct a compile credit because the compile did not succeed.
Updated 1 month ago
COMPILER_002
COMPILER_002 means Pyvorin encountered a syntax construct it does not yet support in native mode. Run pyvorin compile app.py --report to see the fallback reason. You can often work around the issue by refactoring the construct or switching to safe mode.
Updated 1 month ago
COMPILER_003
COMPILER_003 indicates a missing dependency. Ensure the dependency is installed in the active virtual environment and listed in native.extensions if it is allowed for native compilation. Then retry the compile.
Updated 1 month ago
Fallback Errors
Fallbacks are not errors, but they can be surprising when you expect native coverage. Use the fallback report to identify constructs that caused fallback. Common fixes include adding type hints, avoiding dynamic imports, and whitelisting extensions.
Updated 1 month ago
Syntax Not Supported
Some Python syntax is not supported in native compilation. Examples include certain dynamic dispatch patterns and runtime code generation. The compiler falls back to CPython for these constructs, so your program still runs.
Updated 1 month ago