CLI Flags Reference

Complete reference for all ikasolver command-line flags, organized by category.

Input / Output

Flag	Description	Default
`--tree <PATH>`	Path to the `.tree` file to solve. Required unless using `--serve`.	(none)
`-o`, `--output <PATH>`	Output file path for the solved `.iks` strategy file.	(none)
`--table-dir <DIR>`	Directory for caching rank tables and bucket tables. Reusing this directory across runs avoids regenerating expensive lookup tables.	`tables`

Solver

Flag	Description	Default
`-i`, `--iterations <N>`	Number of CFR iterations to run.	`100000`
`--in <N>`	Iterations per node. Total iterations = this value x info set count. Overrides `-i` when specified. Accepts decimal values (e.g., `2.5`).	(none)
`-j`, `--threads <N>`	Number of worker threads.	CPU core count
`--debug`	Enable diagnostic trace output including RNG seeds, regret checksums, and per-iteration traces. Primarily for development and debugging.	off
`--optimize-sizes`	After solving, find the optimal single raise size per node and simplify the tree. Removes raise actions used less than 2% of the time. See Optimise Sizes.	off

Abstraction

Controls how hands are grouped into buckets to reduce memory usage. See Abstraction for a detailed explanation.

Flag	Description	Default
`--flop-buckets <N>`	Number of flop abstraction buckets.	`30`
`--turn-buckets <N>`	Number of turn abstraction buckets.	`30`
`--river-buckets <N>`	Number of river abstraction buckets.	`30`
`--flop-texture <TYPE>`	Flop texture resolution.	`perfect`
`--turn-texture <TYPE>`	Turn texture quality.	`small`
`--river-texture <TYPE>`	River texture quality.	`small`
`--abstraction <VER>`	Abstraction version: `v1` or `v2`.	`v1`

Flop Texture Values

Value	Flop Types	Description
`perfect`	1,755	All canonical flops
`subset-487`	487	Large weighted subset
`subset-373`	373	Medium weighted subset
`subset-198`	198	Small weighted subset
`none`	1	No texture differentiation

Turn Texture Values

Value	Description
`none`	No turn texture grouping
`small`	Small number of turn groups
`medium`	Medium turn groups
`large`	Many turn groups
`perfect`	Full turn resolution

River Texture Values

Value	Description
`none`	No river texture grouping
`small`	Small number of river groups
`large`	More river groups

Abstraction Version Values

Value	Algorithm	Notes
`v1`	Linear Histogram	Faster setup, hierarchical `[N, 4]` bucketing. General-purpose default.
`v2`	K-Means Distributions	More accurate equity-based clustering, flat bucketing. Better for postflop analysis.

Rake

Flag	Description	Default
`--rake <FRACTION>`	Rake as a decimal fraction (e.g., `0.05` for 5%).	`0.0`
`--rake-cap <CHIPS>`	Maximum rake in chips. 0 means no cap.	`0`

Note: the CLI takes rake as a decimal fraction (0.05), while the GUI takes it as a percentage (5). They represent the same thing.

Server

Flag	Description	Default
`--serve [PORT]`	Start as a remote solver WebSocket server. If PORT is omitted, defaults to 9876.	(none)
`--token <TOKEN>`	Authentication token for `--serve` mode. If omitted, a random 32-character token is generated and printed to stderr.	(random)

See Remote Solving and CLI Usage for details.

Bounty

Flag	Description	Default
`--squid-config <PATH>`	Path to a JSON file containing bounty (PKO) configuration. Specifies bounty price, totals, per-player markers, multipliers, and payout rules for progressive or standup bounty formats.	(none)

License

Flag	Description
`--remove-license`	Deactivate the license on this device. Can only be done once every 30 days. The CLI exits after deactivation.

Utility

Flag	Description
`--ram`	Estimate RAM usage for the given tree and settings, print the breakdown, and exit without solving. Useful for checking memory requirements before committing to a long solve.

Examples

# Basic solve with defaults
ikasolver --tree game.tree -i 100000 -o result.iks

# High-accuracy solve
ikasolver --tree game.tree -i 5000000 -j 16 \
  --flop-buckets 50 --turn-buckets 50 --river-buckets 50 \
  --abstraction v2 -o result.iks

# Cash game with rake
ikasolver --tree game.tree -i 1000000 \
  --rake 0.05 --rake-cap 60 -o raked.iks

# Check RAM before solving
ikasolver --tree big_tree.tree --ram

# Remote server
ikasolver --serve 9876 --token mysecret

# PKO bounty solve
ikasolver --tree pko.tree --squid-config bounty.json \
  -i 1000000 -o pko.iks

# Size optimization
ikasolver --tree preflop.tree -i 500000 \
  --optimize-sizes -o optimal.iks

# Per-node iteration scaling with custom table cache
ikasolver --tree game.tree --in 10 \
  --table-dir /mnt/fast/tables -o result.iks