best_engine_ai_helper.cli module

cli — Click command-line interface for best-engine-ai-helper.

Entry point: best-engine-ai-helper (registered in pyproject.toml).

Commands:

detect Print detected hardware as JSON. recommend Print ranked model candidates for this hardware. catalog show Print the merged model catalog as a table. catalog update Refresh the catalog cache from the ApXML model directory. hardware show Print the merged hardware chip table. hardware update Record this machine’s chip and memory into the cache. pull Pull the best model and run Ralph validation gates. validate Run Ralph gates on the already-configured model. env Print the env block for ~/.zshrc or sourcing.

Author

Warith Harchaoui <warith.harchaoui@deraison.ai>

best_engine_ai_helper.cli.catalog_group()

Manage the model catalog.

Return type:

None

best_engine_ai_helper.cli.catalog_show()

Print the merged model catalog as a table.

Return type:

None

best_engine_ai_helper.cli.env_cmd()

Print the env block ready for ~/.zshrc or sourcing.

Reads the written env.sh from ~/.best-engine-ai-helper/env.sh and prints it to stdout. If the file does not exist, suggests running pull first.

Return type:

None

best_engine_ai_helper.cli.hardware_group()

Manage the hardware chip table.

Return type:

None

best_engine_ai_helper.cli.hardware_show()

Print the merged hardware chip table.

Return type:

None

best_engine_ai_helper.cli.hardware_update()

Record this machine’s chip and memory into the hardware cache.

There is no public specs API covering every GPU and Apple Silicon chip, so a refresh captures ground truth for the machine it runs on: the detected chip, its memory pool, and the Ollama-usable share after the OS reservation. The row is upserted into ~/.best-engine-ai-helper/hardware_cache.yaml (keyed on chip + memory tier); the bundled seed is never modified.

Return type:

None

best_engine_ai_helper.cli.validate_cmd()

Run Ralph gates on the already-configured model.

Reads BEST_LLM_TEXT / BEST_LLM_VISION from the environment (sourced from env.sh) and validates both gates. Useful after a manual ollama pull or after an OS update changes GPU availability.

Return type:

None