Pyvorin Docs

Troubleshooting

Common issues and how to resolve them.

Installation

pip cannot find pyvorin-thin

Ensure you include the extra index:

pip install pyvorin-thin --extra-index-url https://pypi.pyvorin.com/simple

If you are behind a corporate proxy, configure pip accordingly or download the wheel manually.

ImportError after installation

Verify you are in the correct virtual environment and that pyvorin-thin appears in pip list. If you have both pyvorin and pyvorin-thin installed, ensure you are calling the right CLI.

Licensing

Licence activation fails

  • Check your network connectivity with pyvorin-thin doctor --network.
  • Verify the API URL: pyvorin-thin config-show.
  • Ensure the key format is PYV-XXXX or as provided by Pyvorin.
  • If running in a closed environment, set PYVORIN_THIN_MOCK_MODE=true for offline development.

Licence status shows invalid

The licence may have expired or the API may be unreachable. Run:

pyvorin-thin licence-check --key PYV-XXXX

If the API is down, events are queued locally and synced automatically when connectivity returns.

Compilation

Remote compile returns "not yet available"

Remote compilation is rolled out region by region. If your region is not yet enabled:

  • Use pyvorin-thin run --local-native if you have the full pyvorin package installed.
  • Run with default fallback: the script executes in CPython and still completes correctly.

Scan reports many unsupported features

This is expected for scripts using async, heavy imports, or dynamic evaluation. Review Supported Workloads and refactor hot paths into simpler functions.

Performance

Benchmark shows no speedup or slowdown

  • Ensure you are measuring warm runs, not cold compiles.
  • Check whether the workload is in the supported set.
  • Small inputs may not amortise compilation overhead.
  • Verify correctness_match=True; a fallback run will be slower than CPython.

Network & Sync

Events are not appearing on the dashboard

  • Run pyvorin-thin sync to drain the offline queue.
  • Check PYVORIN_THIN_OFFLINE_QUEUE_ENABLED is not disabled.
  • Verify the usage API URL in pyvorin-thin config-show.

Getting More Help

If your issue is not listed here, see FAQ or Contact & Support.