bytedance/deer-flow · error · HTTPException

Channel service is not running

Error message

Channel service is not running

What it means

Error "Channel service is not running" thrown in bytedance/deer-flow.

Source

Thrown at backend/app/gateway/routers/channels.py:50

    from app.channels.service import get_channel_service

    service = get_channel_service()
    if service is None:
        return ChannelStatusResponse(service_running=False, channels={})
    status = service.get_status()
    return ChannelStatusResponse(**status)


@router.post("/{name}/restart", response_model=ChannelRestartResponse)
async def restart_channel(name: str, request: Request) -> ChannelRestartResponse:
    """Restart a specific IM channel."""
    await require_admin_user(request, detail=_ADMIN_REQUIRED_DETAIL)

    from app.channels.service import get_channel_service

    service = get_channel_service()
    if service is None:
        raise HTTPException(status_code=503, detail="Channel service is not running")

    success = await service.restart_channel(name)
    if success:
        logger.info("Channel %s restarted successfully", name)
        return ChannelRestartResponse(success=True, message=f"Channel {name} restarted successfully")
    else:
        logger.warning("Failed to restart channel %s", name)
        return ChannelRestartResponse(success=False, message=f"Failed to restart channel {name}")

View on GitHub (pinned to 1dd6ba1acb)

Solutions

1. Start the channel service (enable channels and restart the Gateway) before calling this endpoint.
2. Confirm the Gateway process is running and the channel manager initialized without errors in the logs.

When it happens

Trigger: Thrown at backend/app/gateway/routers/channels.py:50 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/75a3348afe0c1613. Report an issue: GitHub.