help

Troubleshooting

Common issues and how to resolve them.

Published May 30, 2026

Installation

pip cannot find pyvorin-thin

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

ImportError after installation

Verify you are in the correct virtual environment and that pyvorin-thin appears in pip list.

Licensing

Licence activation fails

  • Check network: pyvorin doctor --network
  • Verify API URL: pyvorin config-show
  • Ensure key format is PYV-XXXX

Compilation

Remote compile returns "not yet available"

  • Use pyvorin run --local-native if you have the full pyvorin package.
  • CPython fallback runs automatically.

Performance

Benchmark shows no speedup

  • Ensure warm runs, not cold compiles.
  • Check the workload is in the supported set.
  • Small inputs may not amortise compilation overhead.

Network & Sync

Events not appearing on dashboard

  • Run pyvorin sync to drain the offline queue.
  • Verify usage API URL in pyvorin config-show.