exo-explore/exo · error · Exception

Failed to fetch file list for {model_id=} {revision=} {path=

Error message

Failed to fetch file list for {model_id=} {revision=} {path=} {recursive=}

What it means

Error "Failed to fetch file list for {model_id=} {revision=} {path=} {recursive=}" thrown in exo-explore/exo.

Source

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

            raise
        except HuggingFaceRateLimitError as e:
            if attempt == n_attempts - 1:
                raise
            sleep_for = e.retry_after if e.retry_after is not None else 2.0**attempt
            sleep_for = min(sleep_for, _RATE_LIMIT_MAX_SLEEP_SECS) + random.uniform(
                0, 1
            )
            logger.warning(
                f"Rate limited by HuggingFace fetching file list for {model_id}; "
                f"sleeping {sleep_for:.1f}s before retry {attempt + 2}/{n_attempts}"
            )
            await asyncio.sleep(sleep_for)
        except Exception as e:
            on_connection_lost()
            if attempt == n_attempts - 1:
                raise e
            await asyncio.sleep(2.0**attempt + random.uniform(0, 1))
    raise Exception(
        f"Failed to fetch file list for {model_id=} {revision=} {path=} {recursive=}"
    )


async def _fetch_file_list(
    model_id: ModelId, revision: str = "main", path: str = "", recursive: bool = False
) -> list[FileListEntry]:
    api_url = f"{get_hf_endpoint()}/api/models/{model_id}/tree/{revision}"
    url = f"{api_url}/{path}" if path else api_url
    # ?recursive=true returns the whole subtree in one request
    if recursive:
        url = f"{url}?recursive=true"

    headers = await get_download_headers()
    async with (
        create_http_session(timeout_profile="short") as session,
        session.get(url, headers=headers) as response,
    ):

View on GitHub (pinned to 21a54c5ea0)

When it happens

Trigger: Thrown at src/exo/download/download_utils.py:482 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/d379fb5c24a7b84b. Report an issue: GitHub.