Janus - Distributed Multi-Account Asset Management CLI

"The Watcher of Accounts."

Janus is a lightweight, distributed asset management terminal and middleware built on top of vn.py.

Designed as a modern OEMS (Order Execution Management System) console, Janus connects to multiple underlying trading nodes (gateways). It provides a unified REPL (Read-Eval-Print Loop) interface that allows traders to monitor accounts across brokers in real-time and execute manual interventions across different platforms from a single terminal.

🎯 Project Positioning

• Multi-Broker Hub: Native support for various brokers including Interactive Brokers (IB), Webull, Moomoo, and E-Trade through vn.py gateways.
• Persistent Connectivity: The Janus Server automatically connects to all configured gateways upon startup. The client remains a lightweight interface that stays synchronized with the server's state.
• Account Context Management: A unified CLI where commands are routed to specific accounts. Users can switch the active "default" account context seamlessly.
• Distributed Architecture: Separation of the heavy-duty trading server and the lightweight TUI client via ZeroMQ RPC.
• Unified Strategy Plane: Automated trading strategies are implemented via vn.py and managed directly through the Janus terminal.

🏗️ Architecture

graph TD
    subgraph "Server Side (vn.py Process)"
        A[vn.py Event Engine]
        B[Broker Gateways] -->|Webull/IB/Moomoo/E-Trade| M[Market]
        C[RpcService (Server)]
        S[vn.py Strategy Engine]
        A <--> B
        A <--> C
        A <--> S
    end

    subgraph "Client Side (Janus Terminal)"
        D[RpcService (Client)]
        E[REPL Interface (prompt_toolkit)]
        F[Live Dashboard (Rich TUI)]
        
        D <==>|ZMQ / TCP| C
        E -->|Order/Strategy Request| D
        D -->|Push: Tick/Order/Account| F
        D -->|Push: Log/Notification| E
    end

Loading

🧭 Command Interface

Janus provides a flexible command system for managing multiple accounts from a single session:

• Account context: Use account <name> (e.g., account acct1) to set the default account for subsequent commands.
• Targeted commands: Commands like buy, sell, or cancel target the current default account context.

Core commands

• buy/sell <symbol> <volume> [price] [exchange]: Market if no price, otherwise limit.
• bstop/sstop <symbol> <volume> <stop_price> [limit_price] [exchange]: Stop or stop-limit.
• cancel <vt_orderid>: Cancel an existing order.
• account <name>: Switch the current default account context.
• account list: Show configured accounts, * marks the current default.
• account <name> <command...>: Run a command against an account without changing the default.
• help [command]: Show command help (prints current default account).
• sync: Manual data refresh. Triggers the Janus Server to proactively request a full data update (Account & Positions) from all active account gateways. Use this to ensure the TUI display is aligned with the account's authoritative state.
• exit/quit: Safely disconnect the client and close the terminal.

See docs/order_commands.md for full order command details.

Strategy management (coming soon)

• strategy <action> <name>: Start, stop, or adjust automated vn.py strategies across different accounts.

🚀 Getting Started

1. Configuration: Define your account credentials and gateway settings in config.yaml.
2. Install (uv):
   • uv venv
   • uv pip install -e . --python .venv

IB + Webull in one environment

ib_async removes the need for the official IB pythonclient. The Webull SDK still pins protobuf 4.21.12, so we install it with --no-deps and avoid uv syncing.

Bootstrap helper:

./bootstrap.sh

This installs base deps from pyproject.toml, then installs ib_async and Webull SDK with --no-deps plus Webull's non-protobuf dependencies explicitly.

3. Start Server:
   • uv run --no-sync python -m janus.server (recommended)
   • or .venv/bin/python -m janus.server
4. Start Client:
   • uv run --no-sync python -m janus.client (recommended)
   • or .venv/bin/python -m janus.client