HKUDS/Vibe-Trading · error · TigerDependencyError

tigeropen is not installed; run `pip install tigeropen`.

Error message

tigeropen is not installed; run `pip install tigeropen`.

What it means

_require_tigeropen attempts to import the tigeropen package and raises TigerDependencyError when ModuleNotFoundError occurs. Every client-building path (_client_config, _trade_client, _quote_client) and the availability probe tigeropen_available funnel through it, so any Tiger operation fails fast with an actionable install hint when the SDK is absent.

Source

Thrown at agent/src/trading/connectors/tiger/sdk.py:553

        "order_id": str(order_id),
        "profile": config.profile,
        "account": config.account,
    }
    if symbol:
        result["symbol"] = str(symbol).strip().upper()
    return result


# ---------------------------------------------------------------------------
# SDK plumbing
# ---------------------------------------------------------------------------


def _require_tigeropen() -> ModuleType:
    try:
        import tigeropen  # type: ignore
    except ModuleNotFoundError as exc:
        raise TigerDependencyError("tigeropen is not installed; run `pip install tigeropen`.") from exc
    return tigeropen


def _client_config(cfg: TigerConfig):
    """Build a ``TigerOpenClientConfig`` from connector settings."""
    _require_tigeropen()
    from tigeropen.common.util.signature_utils import read_private_key  # type: ignore
    from tigeropen.tiger_open_config import TigerOpenClientConfig  # type: ignore

    key_path = Path(cfg.private_key_path).expanduser()
    if not key_path.exists():
        raise TigerConfigError(f"Tiger private key not found at {key_path}")
    client_config = TigerOpenClientConfig()
    client_config.private_key = read_private_key(str(key_path))
    client_config.tiger_id = cfg.tiger_id
    client_config.account = cfg.account
    try:
        client_config.timeout = cfg.timeout

View on GitHub (pinned to 80ffdda44c)

Solutions

1. pip install tigeropen in the active environment
2. Verify with python -c 'import tigeropen' using the same interpreter the app runs under
3. If in a container, add tigeropen to the image/requirements and rebuild
4. Alternatively call tigeropen_available() first and disable the Tiger connector when it returns falsy

Example fix

# before
# ModuleNotFoundError -> TigerDependencyError raised on first Tiger call

# after
pip install tigeropen
python -c "import tigeropen; print('ok')"

from agent.src.trading.connectors.tiger import sdk as tiger_sdk

def tiger_ready() -> bool:
    return bool(tiger_sdk.tigeropen_available())

def tigeropen_available() -> bool:
    try:
        import tigeropen  # noqa: F401
        return True
    except ModuleNotFoundError:
        return False

if not tigeropen_available():
    disable_tiger_connector()
else:
    try:
        data = tiger_sdk.get_positions(cfg)
    except TigerDependencyError:
        disable_tiger_connector()

When it happens

Trigger: Calling check_status or any Tiger data function in an environment where the tigeropen package is not installed — e.g. a fresh virtualenv, a deployment image that omitted the optional dependency, or the package being shadowed by a same-named local module.

Common situations: Optional broker dependencies excluded from production requirements; running tests in CI without broker extras; using a different interpreter than the one where tigeropen was pip-installed.

Understand the failure class

Background: "X is not installed. Please install it with pip install Y": missing optional dependency errors — ImportError/ValueError raised when a library's optional extra was never installed — this error's family across 22 libraries.

Related errors

• {alpha_id}: import failed: {exc}
• tushare not installed: {exc}
• futu-api is not installed; run `pip install futu-api`.
• unknown zoo {v!r}; expected one of {sorted(_VALID_ZOOS)}
• {alpha.id}: could not build import spec for {py_file}

AI-assisted analysis of HKUDS/Vibe-Trading@80ffdda44c (2026-08-28). Data as JSON: /api/errors/d7c7a862e0c7e079. Report an issue: GitHub.