| Variable |
Default |
Purpose |
AGENTICML_DIR |
~/.agenticml |
Store root. init(dir=) and --dir win. |
AGENTICML_MODE |
local |
local, offline (alias of local), or disabled. |
AGENTICML_HOST |
unset |
Server for login, whoami, and sync. |
AGENTICML_API_KEY |
unset |
Key for sync and whoami. login ignores it. |
AGENTICML_CONFIG_DIR |
~/.config/agenticml |
Credential directory. Wins over XDG_CONFIG_HOME. |
AGENTICML_MAX_BYTES |
5 GiB |
Warn when the local store grows past this. Nothing is deleted automatically. |
AGENTICML_MEDIA_MAX_PER_KEY |
64 |
Media rows kept per key; older rows are thinned by step. |
AGENTICML_MEDIA_MAX_PX |
1024 |
Longest side of a logged image, when Pillow is installed. |
Read by agenticml run. agenticml.init() also reads AGENTICML_PROJECT, AGENTICML_TASK and AGENTICML_LINEAGE; for the rest, pass the matching init() argument.
| Variable |
Default |
Purpose |
AGENTICML_PROJECT |
repo or directory |
Project name. |
AGENTICML_NAME |
entry script path |
Run name. |
AGENTICML_TAGS |
unset |
Comma-separated tags. |
AGENTICML_NOTES |
unset |
Run launch notes. |
AGENTICML_CONFIG_FILE |
unset |
Path to a JSON configuration file. |
AGENTICML_GROUP |
unset |
Run group. |
AGENTICML_JOB_TYPE |
unset |
Job type. |
AGENTICML_TASK |
inferred |
Task name. |
AGENTICML_PARENT |
inferred |
Lineage parent run ID. |
AGENTICML_ALLOW_CROSS_TASK |
0 |
Set to 1 to silence warnings when task differs from parent’s task. |
AGENTICML_RUN_ID |
unset |
Run ID to resume (requires AGENTICML_RESUME). |
AGENTICML_RESUME |
unset |
Resume mode (never, allow, or must). |
AGENTICML_AUTO_TRACK |
1 |
Detect PyTorch model, optimizer, loss, and dataloader. |
AGENTICML_AUTO_METRICS |
1 |
Log auto/loss, auto/lr, and auto/epoch. |
AGENTICML_LOG_EVERY |
1 |
Frequency of auto metrics in optimizer steps. |
AGENTICML_SYNC_TENSORBOARD |
1 |
Mirror TensorBoard summary events. |
AGENTICML_CAPTURE_ARGS |
1 |
Capture argparse and Hydra arguments in config. |
AGENTICML_SYSTEM_METRICS |
1 |
Sample CPU, memory, and GPU usage (if psutil is installed). |
AGENTICML_SYSTEM_METRICS_INTERVAL |
10.0 |
System metrics sampling interval in seconds. |
AGENTICML_LINEAGE |
1 |
Snapshot Git lineage. |
AGENTICML_TRACK_CODE |
1 |
Snapshot imported source code files. |
AGENTICML_CAPTURE_ENV |
1 |
Capture environment metadata. |
AGENTICML_TRACK_FILES |
unset |
Extra source files to track (os.pathsep-separated). |
AGENTICML_SOURCE_ROOTS |
unset |
Extra source directories (os.pathsep-separated). |
AGENTICML_MAX_FILE_BYTES |
10485760 |
Per-file size cap (10 MiB) for code and lineage snapshots. |
AGENTICML_MAX_TOTAL_BYTES |
104857600 |
Total size cap (100 MiB) for code and lineage snapshots. |
AGENTICML_FLUSH_INTERVAL |
2.0 |
Background metric flush interval in seconds. |
AGENTICML_ALL_RANKS |
0 |
Set to 1 to track all distributed ranks (not only rank 0). |
Read by agenticml server serve and agenticml server up. The full list, with defaults, is in Installation and deployment.
| Variable |
Default |
Purpose |
AGENTICML_SERVER_ADMIN_EMAILS |
unset |
Comma-separated emails granted server admin at their next verified Firebase sign-in. Same as --admin-emails. Ignored without Firebase. |
AGENTICML_SERVER_S3_ENDPOINT_URL |
unset |
Custom S3 endpoint, for MinIO, LocalStack or a VPC endpoint. |
AGENTICML_SERVER_S3_KMS_KEY_ID |
unset |
AWS KMS key ID or ARN. Uploads use aws:kms encryption instead of AES256. |
- A CLI flag overrides its environment variable; a blank environment variable counts as unset.
- Repeatable CLI options (
--track-file, --source-root) replace rather than extend the corresponding environment variable list.
- Boolean switches treat
0, false, no, and off as off.
agenticml.init() defaults auto_metrics and sync_tensorboard to off; agenticml run turns them on.
- There is no positive override flag: once a feature is disabled via its environment variable (such as
AGENTICML_SYSTEM_METRICS=0 or AGENTICML_ALL_RANKS=1), the CLI cannot re-enable it; unset the variable instead.
- See Zero-code runs for details on CLI option syntax.