Knowledgebase
Help articles for accounts, billing, licences, and common compiler questions.
Attach Logs
When reporting a compiler issue, attach the output of pyvorin doctor and the verbose compile log. Do not attach source code unless support explicitly requests it. Command text is redacted by default when using pyvorin report-bug.
Updated 1 month ago
Reopen Ticket
If a resolved ticket needs further attention, you can reopen it from the Support page. Add a new reply explaining why the issue persists. Reopening within a few days is usually faster than creating a new ticket.
Updated 1 month ago
Ticket Status
Support tickets move through statuses such as Open, Pending, and Resolved. You can view the current status and all responses from the Support page. Reply directly in the ticket thread to add more information.
Updated 1 month ago
Contacting Support
Support is available to all customers through the Portal. Opening a ticketSign in to crm.pyvorin.com.Go to Support and click New Ticket.Choose a category (billing, technical, account, general).Describe the issue and attach any relevant reports. Information to includeOutput of pyvorin doctor.The command you ran (or its hash if redaction is enabled).Error codes or fallback reports.Your licence key label (not the full key). Response timesResponse times depend on your plan's support level: community, priority, or dedicated. Billing and account issues are typically handled within one business day. EmailIf you cannot sign in, email support@pyvorin.com from the address associated with your account.
Updated 1 month ago
Rotate Tokens
Rotate API tokens and licence keys periodically as part of good security hygiene. Rotating a token invalidates the old one. Update your scripts and CI secrets before removing the old token.
Updated 1 month ago
Suspicious Device
If you see a device you do not recognize in your licence list, revoke it immediately. After revoking, change your Portal password and review your API tokens. Contact support if you believe your account was compromised.
Updated 1 month ago
API Token Leaked
If you suspect an API token has been leaked, revoke it immediately. Go to API Tokens in the Portal.Find the token.Click Revoke. Create a new token with the minimum required abilities and update your integrations.
Updated 1 month ago
Security Best Practices
Security is built into the Pyvorin platform through authentication, rate limiting, and privacy-conscious telemetry. Account securityUse a strong, unique password.Enable two-factor authentication from the Security page.Review active sessions and revoke devices you do not recognize. API tokensCustomer API tokens are hashed in the database. Create tokens with only the abilities you need (read or read-write) and rotate them periodically. Telemetry privacySource code is not uploaded by default.Command text is hashed unless you explicitly opt in.MAC addresses are hashed; IP addresses are retained with limits. Reporting security issuesEmail security@pyvorin.com or open a confidential support ticket. Do not disclose vulnerabilities in public channels.
Updated 1 month ago
Edge SDK Install
The Edge SDK is installed separately from the Pyvorin CLI. Follow the instructions in the Edge SDK package. The SDK requires a supported Pyvorin CLI version and an eligible licence key.
Updated 1 month ago
Edge Not Available
If Edge options do not appear in your account, your current plan may not include Edge entitlement. Check the Subscription page for Edge features, or contact support to confirm eligibility.
Updated 1 month ago
Edge Runtime FAQ
Pyvorin Edge is a separate runtime and SDK for edge deployments. Do I have Edge access?Edge features are available on eligible plans. Check your subscription details or contact support. How do I install the Edge SDK?The Edge SDK is distributed separately from the Pyvorin CLI. Installation instructions ship with the SDK package. What can I deploy to Edge?Edge targets are designed for constrained, low-latency environments such as CDN workers and IoT gateways. Use build.mode = "edge" in your project configuration. Where is Edge telemetry?Edge runtime health and usage are reported to the Portal if telemetry is enabled in the Edge SDK configuration.
Updated 1 month ago
Speedup Less Than Expected
If the measured speedup is smaller than expected, check the native coverage report. Programs that are I/O-bound or have many fallback constructs often see limited gains. Ensure you are measuring representative workloads and warm caches.
Updated 1 month ago
Memory Usage
Compilation can use significant memory for large projects. Close unnecessary applications, reduce parallel threads, or compile on a machine with more RAM. The Portal shows compile resource usage if telemetry is enabled.
Updated 1 month ago
Slow Compile
Large projects or many fallback constructs can increase compile time. Try increasing build.threads, excluding tests and documentation from compilation, and using balanced mode instead of performance during development.
Updated 1 month ago
Low Native Coverage
Low native coverage means much of your program fell back to CPython. Review the fallback report for the most common reasons. Add type hints, avoid dynamic imports, and whitelist supported extensions to improve coverage. Not all programs can achieve high native coverage. Correctness is prioritized over coverage.
Updated 1 month ago
Performance Tips
Performance improvements from Pyvorin depend on native coverage and workload. Check your native coveragepyvorin compile app.py --report Quick winsUse build mode performance after validating correctness.Increase compilation threads for large projects.Type hot functions to reduce dynamic-type fallbacks. When performance gains are smallI/O-bound programs, scripts dominated by external API calls, and programs with many fallback constructs may not see large speedups. Dashboard widgetThe Compiler Performance widget in the Portal summarizes your compile stats, native percentage, and estimated speedup over time.
Updated 1 month ago
Virtual Environment Issues
If Pyvorin is installed but cannot be found, confirm the correct virtual environment is activated. which pyvorin which python Both should point inside the virtual environment. If not, reactivate the environment or reinstall Pyvorin inside it.
Updated 1 month ago
Unsupported Platform
Pyvorin supports Linux (glibc), macOS 12+, and Windows 10/11 on x86_64 and ARM64. If your platform is not supported, you can run Pyvorin inside a supported container or virtual machine. Check the output of pyvorin doctor for details.
Updated 1 month ago
Permission Denied
Permission errors usually happen when installing into a system Python without sufficient privileges. Use a virtual environment or pipx instead of sudo pip install. This avoids permission issues and keeps dependencies isolated.
Updated 1 month ago
pip Not Found
If the pip command is not found, use the module form: python -m pip install pyvorin Make sure you are using a supported Python version. On some systems, pip may be named pip3.
Updated 1 month ago
Install Errors
Installation problems are usually caused by environment or platform mismatches. pip cannot find pyvorinUpgrade pip: pip install --upgrade pip.Check that you are using a supported Python version (3.10–3.12).Confirm your platform is supported (Linux glibc, macOS 12+, Windows 10/11). Permission errorsUse a virtual environment instead of installing globally:python -m venv .venv source .venv/bin/activate pip install pyvorin Binary not found after installEnsure the virtual environment is activated.Add the virtual environment's bin or Scripts directory to your PATH.On Windows, use pyvorin from PowerShell or CMD. Platform not supportedmusl Linux, 32-bit systems, and older Windows versions are not supported. Use a supported platform or container.
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
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
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