thoa envs
The thoa envs command group lets you view and inspect the compute environments associated with your jobs.
When you submit a job with --tools or --env-source, Thoa builds and validates a conda environment. This environment is saved with a UUID and can be reused in future jobs using --env-id, avoiding the rebuild step.
Environment Statuses
| Status | Meaning |
|---|---|
created | Environment record created; build not yet started |
validating | Environment is currently being built and validated |
validated | Build succeeded; environment is ready to use with --env-id |
validation_failed | Build failed; check build logs with thoa envs show <uuid> -v |
Examples
List all your environments
thoa envs list
Show the 5 most recent environments
thoa envs list --number 5
Inspect a specific environment
thoa envs show b0f9fefe-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Inspect with full build logs (useful for debugging failures)
thoa envs show b0f9fefe-xxxx-xxxx-xxxx-xxxxxxxxxxxx --verbose
Commands
thoa envs list
Displays all your environments in a table:
| Column | Description |
|---|---|
| ID | Full environment UUID (use this with --env-id) |
| Type | Environment type (e.g. conda) |
| Status | Color-coded: green = validated, red = failed, blue = validating, yellow = created |
| Created | When the environment was created |
| Tools | First few packages from the environment spec |
thoa envs list
| Flag | Description |
|---|---|
--number, -n | Limit how many environments to display |
thoa envs show <UUID>
Prints full details of a single environment: ID, type, status, created/updated timestamps, and the full conda spec YAML.
thoa envs show b0f9fefe-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Add --verbose (or -v) to also print the build logs. This is especially useful for diagnosing why an environment failed to validate:
thoa envs show b0f9fefe-xxxx-xxxx-xxxx-xxxxxxxxxxxx -v
| Flag | Description |
|---|---|
--verbose, -v | Also print environment build logs |