Skip to main content

Python Quick Start

The Python runtime is published on PyPI. The deployed generator can select an older runtime than the latest published package; check Latest Versions, then keep the dependency emitted by the generated workspace for the first verification.

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
cargo teaql services
cargo teaql evaluate --input models/
cargo teaql python-lib-core --input models/ --output generated/python-lib-core
cargo teaql python-app-console --input models/ --output generated/python-app-console

Install the generated application's dependencies as directed by its own pyproject.toml or README. Read its AGENTS.md before changing application code. Do not inspect generated Q.py, entity, or Request files just to discover an API; ask the current service for focused guidance:

cargo teaql python-assist-query/school --input models/
cargo teaql python-assist-query/school.name --input models/
cargo teaql python-assist-ensure-schema --input models/

The executable startup path must install the generated module and explicitly ensure schema with a trusted context. Confirm its root and constants are seeded and that repeating startup does not duplicate them. Then exercise a bounded, intent-declared Q query, a loaded E expression, Checker/Fix, and an audited create/update. Do not use a bare entity-descriptor schema call or hand-written SQL seed as a substitute for the module-level path.

Use the generated application's exact API and test commands; keep a clean consumer run separate from runtime-local example testing. See Python First Verification.