Skip to content

Commit ebfe844

Browse files
committed
docs(cli): add note about tasks vs workers and seed regex
1 parent 4b8acf9 commit ebfe844

1 file changed

Lines changed: 4 additions & 2 deletions

File tree

docs/cli.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,7 @@ model_config:
8888
!!! note "How Balatro instances are started"
8989

9090
`balatrollm` starts/stops Balatro instances automatically via `balatrobot`. With `--parallel N`, it spawns instances on ports `--port` through `--port + N - 1` (`port..port+parallel-1`).
91+
When using `--parallel N`, N workers are spawned. In order to fully utilize you have to have more tasks than workers. Check out th number of tasks that will be created using the `--dry-run` option.
9192

9293
!!! note "Multiple Values"
9394

@@ -97,6 +98,7 @@ The following values can be provided for `deck` and `stake` options:
9798

9899
- **Decks:** `RED`, `BLUE`, `YELLOW`, `GREEN`, `BLACK`, `MAGIC`, `NEBULA`, `GHOST`, `ABANDONED`, `CHECKERED`, `ZODIAC`, `PAINTED`, `ANAGLYPH`, `PLASMA`, `ERRATIC`
99100
- **Stakes:** `WHITE`, `RED`, `GREEN`, `BLACK`, `BLUE`, `PURPLE`, `ORANGE`, `GOLD`
101+
- **Seeds:** no strict rules but it is suggested to follow the regex `^[1-9A-Z]{1,8}$` for deterministic results.
100102

101103
## Examples
102104

@@ -123,8 +125,8 @@ balatrollm config/example.yaml --model openai/gpt-5 --seed BBBBBBB
123125
# Multiple seeds and decks (generates cartesian product of all combinations)
124126
balatrollm --model openai/gpt-5 --deck RED BLUE --seed AAAAAAA BBBBBBB
125127
126-
# Run multiple game instances concurrently
127-
balatrollm --model openai/gpt-5 --parallel 4
128+
# Run multiple game instances concurrently (2 workers, 1 model x 3 seed = 3 tasks)
129+
balatrollm --model openai/gpt-5 --parallel 2 --seed AAAAAAA BBBBBBB CCCCCCC
128130
129131
# Preview tasks without executing
130132
balatrollm config/example.yaml --dry-run

0 commit comments

Comments
 (0)