bytedance/deer-flow · error · HTTPException

Console requires a SQL database backend; set database.backen

Error message

Console requires a SQL database backend; set database.backend to sqlite or postgres in config.yaml.

What it means

Error "Console requires a SQL database backend; set database.backend to sqlite or postgres in config.yaml." thrown in bytedance/deer-flow.

Source

Thrown at backend/app/gateway/routers/console.py:124

    """Daily token-usage series plus per-model breakdown for the window."""

    days: list[ConsoleUsageDay]
    by_model: dict[str, ConsoleUsageModelBreakdown]
    total_tokens: int
    total_runs: int
    total_cost: float | None = Field(default=None, description="Estimated spend for the window; null when no pricing is configured")
    currency: str | None = Field(default=None, description="Display currency taken from the first configured pricing entry")


# ---------------------------------------------------------------------------
# Helpers
# ---------------------------------------------------------------------------


def _session_factory_or_503():
    sf = get_session_factory()
    if sf is None:
        raise HTTPException(
            status_code=503,
            detail="Console requires a SQL database backend; set database.backend to sqlite or postgres in config.yaml.",
        )
    return sf


def _as_utc(dt: datetime | None) -> datetime | None:
    """Normalize DB timestamps: SQLite round-trips them naive, Postgres aware."""
    if dt is None:
        return None
    return dt.replace(tzinfo=UTC) if dt.tzinfo is None else dt


# ---------------------------------------------------------------------------
# Pricing — real spend estimation
# ---------------------------------------------------------------------------

View on GitHub (pinned to 1dd6ba1acb)

Solutions

1. Set database.backend to sqlite or postgres in config.yaml and restart the Gateway.
2. The console requires persisted SQL state; memory backend is not supported.

When it happens

Trigger: Thrown at backend/app/gateway/routers/console.py:124 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bytedance/deer-flow@1dd6ba1acb (2026-08-14). Data as JSON: /api/errors/47786b0616f59c9d. Report an issue: GitHub.