Configuration reference

The worker is configured entirely through environment variables. This page lists the required deployment values and the analysis knobs. For how to supply them during a deployment, see Deploy the analyzer worker.

Required variables

Set all seven of these for the worker to start and serve.

Variable	Description
INSTRUCTION_HUB_RUNTIME_BASE_URL	Base URL of the hosted Promptless Runtime the worker syncs with.
INSTRUCTION_HUB_INSTALL_TOKEN	The plih_ install token that authenticates this deployment to hosted Promptless.
INSTRUCTION_HUB_DEPLOYMENT_NAME	A human-readable name for this worker deployment.
INSTRUCTION_HUB_DEPLOYMENT_INSTANCE_ID	The stable instance identifier used when hosted Promptless verifies host credentials.
INSTRUCTION_HUB_CONFIG_HASH	A hash of the deployment configuration.
INSTRUCTION_HUB_CUSTOMER_POSTGRES_DSN	Connection string for the Postgres database you own.
INSTRUCTION_HUB_TRACE_OBJECT_S3_BUCKET	The S3 bucket you own, for raw traces and canonical trace objects.

Caution

Treat INSTRUCTION_HUB_INSTALL_TOKEN and INSTRUCTION_HUB_CUSTOMER_POSTGRES_DSN as secrets. Supply them through your secret store rather than plain values.

Analysis variables

The INSTRUCTION_HUB_ANALYSIS_* variables turn on and configure the Friction Analyzer. They are set together — the analyzer needs its model and repository configured to run.

Variable	Description
INSTRUCTION_HUB_ANALYSIS_ACTIVATION_AT	When analysis becomes active for this deployment.
INSTRUCTION_HUB_ANALYSIS_MODEL_PROVIDER	The model provider: openai, azure_openai, or aws_bedrock.
INSTRUCTION_HUB_ANALYSIS_MODEL_AUTHENTICATION	How the worker authenticates to the provider.
INSTRUCTION_HUB_ANALYSIS_MODEL_BASE_URL	The provider’s base URL.
INSTRUCTION_HUB_ANALYSIS_MODEL_NAME	The analysis model to use. Defaults to gpt-5.6-sol.
INSTRUCTION_HUB_ANALYSIS_MODEL_API_KEY	The API key, when the provider uses API-key authentication.
INSTRUCTION_HUB_ANALYSIS_REPOSITORY_URL	The Instruction Hub repository the analyzer reads and remediates against.
INSTRUCTION_HUB_ANALYSIS_REPOSITORY_ID	The repository identifier.
INSTRUCTION_HUB_ANALYSIS_REPOSITORY_FULL_NAME	The repository’s full owner/name.
INSTRUCTION_HUB_ANALYSIS_REPOSITORY_TOKEN	A repository-scoped token the remediation flow uses to open pull requests.
INSTRUCTION_HUB_ANALYSIS_QUIET_WINDOW_HOURS	How long a session stays quiet before it is eligible for analysis. Defaults to 0.5.
INSTRUCTION_HUB_ANALYSIS_MIRROR_ROOT	Local root for the analyzer’s repository mirror.

Caution

INSTRUCTION_HUB_ANALYSIS_MODEL_API_KEY and INSTRUCTION_HUB_ANALYSIS_REPOSITORY_TOKEN are credential material — the provider API key and the repository-scoped token the remediation flow uses. Supply them through your secret store rather than as plain values.