guides
Error Handling and Diagnostics
Interpret compiler errors, failure codes, and diagnostic messages.
Published May 30, 2026
Failure Stages
| Stage | Meaning |
|---|---|
parse | Python source could not be parsed into AST. |
validate | AST validation failed (unsupported constructs). |
compile | Native compilation produced errors. |
link | Linking shared libraries failed. |
artifact | Artifact packaging or upload failed. |
Common Error Codes
| Code | Resolution |
|---|---|
UNSUPPORTED_LANGUAGE_FEATURE | Refactor to remove generators or async/await. |
TYPE_MISMATCH | Add type hints or stabilise variable types. |
LICENSE_INVALID | Run pyvorin licence-check. |
TIMEOUT | Increase request_timeout_seconds or retry. |
NETWORK_ERROR | Check connectivity; events queued locally. |
Reading Compiler stderr
pyvorin job details JOB_IDLook for the compiler_stderr field for low-level error messages.