Skip to content

main

__main__

Top-level dispatcher for the tradingagents console script.

A thin fire-driven router that exposes run_cli and run_tui as the cli and tui subcommands respectively. The --help / -h / "help" cases are intercepted before fire ever sees them so help output is rendered as Rich panels directly to stdout instead of through fire's default pager (less-style) UI.

This module doubles as both the "python -m tradingagents" entry point and the [project.scripts] target in pyproject.toml, so there is exactly one routing surface.

Examples:

>>> # tradingagents                     # rich app help (no pager)
>>> # tradingagents --help              # same as above
>>> # tradingagents help cli            # rich per-command help
>>> # tradingagents cli --help          # same as above
>>> # tradingagents cli --ticker AAPL   # actually run cli
>>> # tradingagents tui                 # interactive run
>>> # python -m tradingagents cli ...   # equivalent to the above

Functions:

Name Description
main

Entry point for the tradingagents console script.

COMMANDS 

COMMANDS: dict[str, Callable[..., Any]] = {'cli': run_cli, 'tui': run_tui}

main 

main() -> None

Entry point for the tradingagents console script.

Routing rules (checked in order before delegating to fire):

  1. No arguments -> top-level Rich help.
  2. First arg is --help, -h, or "help" -> top-level help, or per-command help when followed by a known subcommand (e.g. tradingagents help cli).
  3. First arg is a known subcommand and any following arg is --help or -h -> per-command Rich help.
  4. Otherwise: hand off to :func:fire.Fire for actual dispatch.
Source code in src/tradingagents/__main__.py 
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def main() -> None:
    """Entry point for the tradingagents console script.

    Routing rules (checked in order before delegating to fire):

    1. No arguments -> top-level Rich help.
    2. First arg is --help, -h, or "help" -> top-level help, or
       per-command help when followed by a known subcommand
       (e.g. tradingagents help cli).
    3. First arg is a known subcommand and any following arg is --help
       or -h -> per-command Rich help.
    4. Otherwise: hand off to :func:`fire.Fire` for actual dispatch.
    """
    args = sys.argv[1:]
    console = Console()

    if not args or args[0] in _HELP_FLAGS or args[0] == "help":
        target = args[1] if len(args) >= 2 else None
        if target and target in COMMANDS:
            print_command_help(console, target, COMMANDS[target])
        else:
            print_app_help(console, COMMANDS)
        return

    cmd_name = args[0]
    if cmd_name in COMMANDS and any(a in _HELP_FLAGS for a in args[1:]):
        print_command_help(console, cmd_name, COMMANDS[cmd_name])
        return

    fire.Fire(COMMANDS, name="tradingagents")