exo-explore/exo · error · Exception

Failed to fetch file list: {response.status}

Error message

Failed to fetch file list: {response.status}

What it means

Error "Failed to fetch file list: {response.status}" thrown in exo-explore/exo.

Source

Thrown at src/exo/download/download_utils.py:527

        elif response.status == 200:
            data_json = await response.text()
            data = TypeAdapter(list[FileListEntry]).validate_json(data_json)
            files: list[FileListEntry] = []
            for item in data:
                if item.type == "file":
                    files.append(FileListEntry.model_validate(item))
                elif item.type == "directory" and recursive:
                    # already inlined by ?recursive=true
                    continue
            if recursive and len(data) >= 1000:
                # HF tree endpoint paginates at 1000; we don't follow cursors
                logger.warning(
                    f"File list for {model_id} hit the 1000-entry page cap "
                    "and may be truncated; cursor pagination is not implemented"
                )
            return files
        else:
            raise Exception(f"Failed to fetch file list: {response.status}")


async def get_download_headers() -> dict[str, str]:
    return {**(await get_auth_headers()), "Accept-Encoding": "identity"}


def create_http_session(
    auto_decompress: bool = False,
    timeout_profile: Literal["short", "long"] = "long",
) -> aiohttp.ClientSession:
    if timeout_profile == "short":
        total_timeout = 30
        connect_timeout = 10
        sock_read_timeout = 30
        sock_connect_timeout = 10
    else:
        total_timeout = 1800
        connect_timeout = 60

View on GitHub (pinned to 21a54c5ea0)

When it happens

Trigger: Thrown at src/exo/download/download_utils.py:527 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of exo-explore/exo@21a54c5ea0 (2026-08-26). Data as JSON: /api/errors/ea58e432edb506f0. Report an issue: GitHub.