CLI Reference
The Norcaster CLI is the command-line interface to the AI Runtime Control Plane. Deploy with enforcement, validate contracts, run inference through the execution boundary, and audit outcomes.
Enforcement is strict by default.
For the full story—rules, document lookup, model output, quality checks (evals), and traces—see the controlled request walkthrough on the examples page.
pip install norcasterInstallKey concepts
CPU vs GPU
By default, models run on CPU. Add --gpu or -g to deploy with GPU.
# CPU (default)
norcaster deploy my-llama-7b
# GPU
norcaster deploy my-llama-7b --gpu
Contract config (--config)
Pass pipeline_lock with schema, features, and policies. Default mode is enforce.
# Deploy with contract (schema + policies)
norcaster deploy my-model -c '{"pipeline_lock": {"contract_version": "1.0", "mode": "enforce", "schema": {...}, "features": {"type": "text"}}}'
Most commands require an API key. Set NORCASTER_API_KEY or use --api-key. For a custom API URL, use --url or NORCASTER_API_URL.
Command reference
Authentication
norcaster signup
Create a new account. A verification email will be sent — click the link, then create an API key in the portal.
Options
--email, -e · --password, -p · --url
norcaster verify <token>
Verify email. Use the token from the verification link.
Options
--url
norcaster resend-verification
Resend verification email.
Options
--email, -e · --url
norcaster login
Check your credentials. API keys are created in the portal under Settings → API keys; set NORCASTER_API_KEY.
Options
--email, -e · --password, -p · --url · --verbose, -v
norcaster forgot-password
Request password reset. Check your inbox for the reset link.
Options
--email, -e · --url
norcaster reset-password <token>
Reset password using token from the email link.
Options
--password, -p · --url
API keys
norcaster api-keys
List API keys for your account.
Options
--api-key, -k · --url
norcaster create-api-key
Create a new API key. The key is shown only once — save it.
Options
--name, -n · --api-key, -k · --url
norcaster revoke-api-key <key_id>
Revoke an API key. It will stop working immediately.
Options
--api-key, -k · --url
norcaster rotate-api-key
Create a new API key and revoke the current one. Update NORCASTER_API_KEY with the new key.
Options
--api-key, -k · --url
Deployment & contracts
norcaster deploy <model_id>
Deploy a model with optional contract config (schema, features, policies). Use --config for pipeline_lock JSON.
Options
--config, -c · --gpu, -g · --update · --api-key, -k · --url
norcaster deployments
List deployments with revision counts.
Options
--limit, -n · --api-key, -k · --url
norcaster revisions <deployment_id>
List revisions for a deployment. Use norcaster rollback to restore a previous revision.
Options
--api-key, -k · --url
norcaster rollback <deployment_id> <revision>
Rollback deployment to a previous revision.
Options
--api-key, -k · --url
Runtime enforcement
norcaster run <deployment_id>
Run inference. Input is enforced against the deployment contract before execution. Blocked when policy rejects the request.
Options
--input, -i · --api-key, -k · --url
norcaster contract validate <deployment_id>
Validate input against deployment contract without enqueueing (dry-run). No execution.
Options
--input, -i · --api-key, -k · --url
norcaster policy list <deployment_id>
Show policies and schema for a deployment (mode, input_schema, top violation codes).
Options
--api-key, -k · --url
Audit & observability
norcaster status <resource_id>
Get status of a deployment or job.
Options
--api-key, -k · --url
norcaster audit <deployment_id>
Enforcement audit: allowed/blocked/warned counts and top violation codes.
Options
--limit, -n · --api-key, -k · --url
norcaster usage
Get usage stats (tokens, compute seconds, job count). Optionally filter by date range.
Options
--start, -s · --end, -e · --api-key, -k · --url
Enforcement is strict by default. No request executes without passing validation.