Environment configuration¶

GPTNT reads paths, runtime endpoints, game settings, instrumentation flags, and service timeouts from environment variables. This page groups each value by the object or command that owns it.

Paths and command inputs¶

EXPERIMENT_RECORDER_OUTPUTS selects the directory written by child recorder processes. EXPERIMENT_RECORDER selects an existing directory read by a command. They are different boundaries.

Runtime endpoints¶

GPTNT_MANUAL_ARTIFACTS is not user-authored configuration. gptnt run serialises doctor-validated manual paths into it for player child processes, keyed by profile-and-rule-seed requirement.

Display¶

On Linux, DISPLAY identifies the X display inherited by a game process. A manifest displays list overrides it per room by assigning :<number> round-robin. Omitting displays leaves the ambient value unchanged.

KTANE settings¶

KtaneSettings uses the KTANE_ prefix.

GPTNT sets child-process GAME_WIDTH and GAME_HEIGHT from the configured dimensions. Configure the KTANE_ values rather than setting those child variables directly.

Observability¶

ObservabilitySettings uses the OBSERVABILITY_ prefix except for the standard OTLP endpoint.

The run-manifest presets have these effects:

Service timeouts¶

ServiceTimeouts has no environment prefix. Pydantic Settings accepts the uppercase field name. All values are seconds.

Changing a timeout changes failure detection and can alter resource retention. Use the default unless the deployment has a measured need for another value.

Generated settings¶

These generated models document values accepted by the current runtime. Their module paths are not supported Python extension interfaces.

em_host: str = Field(default='localhost', validation_alias='GPTNT_EM_HOST')

em_port: int = Field(default=8085, validation_alias='GPTNT_EM_PORT')

redis_dsn: RedisDsn = Field(default=RedisDsn('redis://localhost:6379'), validation_alias='REDIS_DSN')

em_base_url: str

em_health_url: str

instrument_httpx: bool = True

limited() -> Self

off() -> Self

heartbeat_repeat_interval: float = 3

heartbeat_check_interval: float = 2

heartbeat_expiration: float = 10

tombstone_expiration: float = 120

game_state_interval: float = 2

get_bomb_state_timeout: float = 10

get_observation_timeout: float = 60

update_metrics_interval: float = 5

configure_services_timeout: float = 60

run_forward_pass_timeout: float = 600

redis_rpc_timeout: float = 600

maximum_experiment_duration: float = 12000

session_state_watcher_interval: float = 1

game_request_timeout: float = 5

External integrations¶

GPTNT passes provider, W&B, OpenTelemetry, and submission variables to the external library that owns them. Common local boundaries include:

• WANDB_ENTITY, WANDB_PROJECT, and WANDB_MODE for W&B completion and recording.
• Provider credentials such as ANTHROPIC_API_KEY, AZURE_OPENAI_API_KEY, ANTHROPIC_FOUNDRY_API_KEY, and VLLM_API_KEY.
• LOGFIRE_TOKEN for the production collector deployment.
• GITHUB_TOKEN for remote submission operations.

Use the provider's documentation for its complete variable set. The provider configuration and provider troubleshooting pages cover the GPTNT boundary. Do not place credentials in a tracked run, player, or provider configuration.