Project Configuration

Pyvorin reads project settings from pyvorin.toml in the project root. If that file is missing, it falls back to [tool.pyvorin] inside pyproject.toml.

Example pyvorin.toml

[project]
name = "my-app"
entry = "app.py"
output_dir = "./build"
python_version = "3.11"

[build]
mode = "balanced"
threads = 4
optimize = true

[native]
extensions = ["numpy", "pydantic"]
exclude = ["tests", "docs"]

[fallback]
allow = true
log_reasons = true

[telemetry]
enabled = true
redact_commands = true

Configuration keys

• project.entry — main entry point file.
• project.output_dir — directory for build artifacts.
• build.mode — safe, balanced, performance, or edge.
• native.extensions — third-party packages allowed in the native build.
• fallback.allow — whether to permit CPython fallback.
• telemetry.enabled — send compile and error events to the Portal.

Per-command overrides

pyvorin compile app.py --mode=performance --threads=8