ooai_llm.cli.help¶

Shared CLI help text and parser helpers.

Purpose:: Keep the command-line interface teachable without letting cli.py grow into a pile of duplicated help strings and option builders.

Attributes¶

`MODEL_CAPABILITY_CHOICES`
`MODEL_CATALOG_SORT_CHOICES`
`MODEL_COMPARE_SORT_CHOICES`
`LCB_PRO_DIFFICULTY_CHOICES`
`LCB_PRO_SORT_CHOICES`
`ROOT_HELP`
`ROOT_EXAMPLES`
`MODELS_EXAMPLES`
`MODEL_LIST_EXAMPLES`
`MODEL_COMPARE_EXAMPLES`
`MODEL_CHEAPEST_EXAMPLES`
`MODEL_CODING_EXAMPLES`
`MODEL_SUITE_EXAMPLES`
`PROFILES_EXAMPLES`
`BENCHMARKS_EXAMPLES`

Functions¶

`package_version`(→ str)	Return the installed package version for `--version` output.
`add_provider_args`(→ None)	Add repeatable and comma-separated provider options.
`add_catalog_filter_args`(→ None)	Add common model catalog filters used by list/compare/suite commands.
`add_compare_args`(→ None)	Add common cost-comparison options.

Module Contents¶

ooai_llm.cli.help.MODEL_CAPABILITY_CHOICES = ('chat', 'reasoning', 'coding', 'vision', 'function_calling', 'tool_calling', 'tool_choice',...[source]¶

ooai_llm.cli.help.MODEL_CATALOG_SORT_CHOICES = ('recency', 'provider', 'model', 'cost', 'input_cost', 'output_cost', 'context', 'input_tokens',...[source]¶

ooai_llm.cli.help.MODEL_COMPARE_SORT_CHOICES = ('call_cost', 'cost', 'calls', 'calls_per_usd', 'provider', 'model', 'input_tokens',...[source]¶

ooai_llm.cli.help.LCB_PRO_DIFFICULTY_CHOICES = ('easy', 'medium', 'hard')[source]¶

ooai_llm.cli.help.LCB_PRO_SORT_CHOICES = ('rating', 'provider', 'organization', 'model', 'status')[source]¶

ooai_llm.cli.help.ROOT_HELP = Multiline-String[source]¶

Show Value

"""Utilities for choosing, comparing, configuring, and inspecting LLMs.

Mental model:
  Catalog/suite       choose and compare models
  ChatModelProfile    serialize model configuration
  LLM                 invoke a model and record observed usage/cost
"""

ooai_llm.cli.help.ROOT_EXAMPLES = Multiline-String[source]¶

Show Value

"""Common tasks:
  List cheap Mistral models:
    ooai-llm models cheapest --providers mistral --limit 10

  Compare coding-capable models for a 10k/2k call:
    ooai-llm models coding --providers openai,anthropic,mistral --input-tokens 10000 --output-tokens 2000

  Find tool + structured-output models:
    ooai-llm models list --source litellm --tool-calling-only --structured-output-only --sort output_tokens

  Explore the full raw LiteLLM registry:
    ooai-llm models list --all-litellm --format table
    ooai-llm tui --catalog-all

  Build a reusable model suite:
    ooai-llm models suite --suite comparison --providers openai,anthropic,mistral

  Validate and resolve a serializable profile:
    ooai-llm profiles validate --input profile.json
    ooai-llm profiles resolve --input profile.json --format json

  Print copy/paste CLI and Python recipes:
    ooai-llm recipes --topic coding
    ooai-llm recipes --topic rich

  Launch the optional interactive explorer:
    ooai-llm tui --theme paper
    ooai-llm tui --providers mistral --views cheapest,catalog --limit 10

Use --format json or --format csv for automation. Use --no-rich for deterministic plain tables.
"""

ooai_llm.cli.help.MODELS_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm models cheapest --providers mistral --limit 10
  ooai-llm models coding --providers openai,anthropic,mistral --tool-calling-only
  ooai-llm models list --source litellm --providers openai,mistral --sort cost --limit 0
  ooai-llm models list --all-litellm --providers openrouter --limit 0
  ooai-llm models compare --source litellm --providers mistral --input-tokens 10000 --output-tokens 2000
  ooai-llm models suite --from-catalog --coding-only --sort cost --limit 5
"""

ooai_llm.cli.help.MODEL_LIST_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm models list --source litellm --providers mistral --sort cost --limit 0
  ooai-llm models list --all-litellm --limit 0
  ooai-llm models list --all-litellm --providers fireworks_ai,openrouter --limit 0
  ooai-llm models list --source litellm --tool-calling-only --structured-output-only --sort output_tokens
  ooai-llm models list --source litellm --released-after 2026-01 --min-input-tokens 128000
"""

ooai_llm.cli.help.MODEL_COMPARE_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm models compare --source litellm --providers mistral --input-tokens 10000 --output-tokens 2000
  ooai-llm models compare --source litellm --providers openai,anthropic,mistral --baseline openai:gpt-5-mini
  ooai-llm models compare --source litellm --coding-only --tool-calling-only --sort call_cost
"""

ooai_llm.cli.help.MODEL_CHEAPEST_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm models cheapest --providers mistral --limit 10
  ooai-llm models cheapest --providers openai,anthropic,google,deepseek,mistral --per-provider
  ooai-llm models cheapest --structured-output-only --input-tokens 5000 --output-tokens 1000 --budget-usd 20
"""

ooai_llm.cli.help.MODEL_CODING_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm models coding --providers mistral --limit 10
  ooai-llm models coding --providers openai,anthropic,google,deepseek,mistral --per-provider
  ooai-llm models coding --tool-calling-only --structured-output-only --min-output-tokens 8000
"""

ooai_llm.cli.help.MODEL_SUITE_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm models suite --suite comparison --providers openai,anthropic,mistral
  ooai-llm models suite --from-catalog --coding-only --sort cost --limit 5
  ooai-llm models suite --suite comparison --parallel-tool-calls false --format json
"""

ooai_llm.cli.help.PROFILES_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm profiles validate --input profile.json
  ooai-llm profiles render --input profile.json
  ooai-llm profiles resolve --input profile.json --format json
"""

ooai_llm.cli.help.BENCHMARKS_EXAMPLES = Multiline-String[source]¶

Show Value

"""Examples:
  ooai-llm benchmarks lcb-pro summary
  ooai-llm benchmarks lcb-pro models --status active --limit 10
  ooai-llm benchmarks lcb-pro difficulty --difficulty hard --provider openai
"""

ooai_llm.cli.help.package_version() → str[source]¶: Return the installed package version for --version output.

ooai_llm.cli.help.add_provider_args(command: argparse.ArgumentParser, *, noun: str = 'Provider') → None[source]¶: Add repeatable and comma-separated provider options.

ooai_llm.cli.help.add_catalog_filter_args(command: argparse.ArgumentParser, *, context_word: str = 'show') → None[source]¶: Add common model catalog filters used by list/compare/suite commands.

ooai_llm.cli.help.add_compare_args(command: argparse.ArgumentParser, *, default_sort: str = 'call_cost', default_limit: int = 20) → None[source]¶: Add common cost-comparison options.