WorkerSettings reference

WorkerSettings contains validated runtime policy for one worker deployment.

from modal_devin import WorkerSettings

Common settings

Field	Type	Default	Use
`scheduler_interval_seconds`	`int`	`3`	How often the generated schedule checks for work
`session_timeout_seconds`	`int`	`43200`	Maximum Devin worker duration
`snapshot_ttl_seconds`	`int \| None`	`2592000`	Retention for a resumable workspace; `None` is indefinite
`log_level`	`str`	`"INFO"`	`modal_devin.worker` log detail

Advanced recovery settings

Change these only for a diagnosed deployment or with support guidance:

Field	Type	Default	Use
`api_timeout_seconds`	`float`	`30.0`	Per-request timeout for Devin APIs
`status_attempts`	`int`	`3`	Final-state lookup attempts
`status_retry_delay_seconds`	`float`	`1.0`	Base delay between final-state attempts
`status_watchdog_interval_seconds`	`float`	`60.0`	How often a running worker confirms its session is still live
`session_attach_timeout_seconds`	`float`	`120.0`	How long a gateway-connected worker waits for Devin to attach before reconnecting fresh
`sandbox_ready_timeout_seconds`	`int`	`120`	Maximum Sandbox startup wait
`snapshot_timeout_seconds`	`int`	`120`	Maximum filesystem preservation time
`claim_connect_margin_seconds`	`int`	`15`	Time reserved for the worker to connect before its claim deadline

Environment variables

WorkerSettings.from_env() reads:

Environment variable	Default
`MODAL_DEVIN_SCHEDULER_INTERVAL_SECONDS`	`30`
`MODAL_DEVIN_SESSION_TIMEOUT_SECONDS`	`43200`
`MODAL_DEVIN_SNAPSHOT_TTL_SECONDS`	`2592000`
`MODAL_DEVIN_LOG_LEVEL`	`INFO`
`MODAL_DEVIN_API_TIMEOUT_SECONDS`	`30.0`
`MODAL_DEVIN_STATUS_ATTEMPTS`	`3`
`MODAL_DEVIN_STATUS_RETRY_DELAY_SECONDS`	`1.0`
`MODAL_DEVIN_STATUS_WATCHDOG_INTERVAL_SECONDS`	`60.0`
`MODAL_DEVIN_SESSION_ATTACH_TIMEOUT_SECONDS`	`120.0`
`MODAL_DEVIN_SANDBOX_READY_TIMEOUT_SECONDS`	`120`
`MODAL_DEVIN_SNAPSHOT_TIMEOUT_SECONDS`	`120`
`MODAL_DEVIN_CLAIM_CONNECT_MARGIN_SECONDS`	`15`

For snapshot retention, none and null mean indefinite retention. Names are exact; unrecognized MODAL_DEVIN_* variables are ignored.

Validation

Durations, counts, and timeouts must be positive, except that status retry delay may be zero and snapshot retention may be None. Log level is case-insensitive and accepts CRITICAL, ERROR, WARNING, INFO, or DEBUG. Invalid values raise ConfigurationError during application startup.

Derived function timeout

worker.session_function_timeout_seconds provides the minimum function duration needed for the configured worker run plus startup, final-state handling, filesystem preservation, and cleanup. Use the property in the generated decorator instead of copying a numeric value.

Tutorials

How-to guides

Concepts

Reference

WorkerSettings reference

Common settings

Advanced recovery settings

Environment variables

Validation

Derived function timeout

​Common settings

​Advanced recovery settings

​Environment variables

​Validation

​Derived function timeout

Common settings

Advanced recovery settings

Environment variables

Validation

Derived function timeout