exo-explore/exo · error · FileNotFoundError

Failed to fetch file list for {model_id}: {e}

Error message

Failed to fetch file list for {model_id}: {e}

What it means

Error "Failed to fetch file list for {model_id}: {e}" thrown in exo-explore/exo.

Source

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

        logger.opt(exception=e).warning(
            "Ran into exception when fetching file list from HF."
        )

        if await aios.path.exists(cache_file):
            logger.warning(
                f"No cached file list for {model_id} - using local file list"
            )
            async with aiofiles.open(cache_file, "r") as f:
                return TypeAdapter(list[FileListEntry]).validate_json(await f.read())
        local_file_list = await _build_file_list_from_local_directory(
            model_id, recursive
        )
        if local_file_list is not None:
            logger.warning(
                f"Failed to fetch file list for {model_id} and no cache exists, using local file list"
            )
            return local_file_list
        raise FileNotFoundError(f"Failed to fetch file list for {model_id}: {e}") from e


async def fetch_file_list_with_retry(
    model_id: ModelId,
    revision: str = "main",
    path: str = "",
    recursive: bool = False,
    on_connection_lost: Callable[[], None] = lambda: None,
) -> list[FileListEntry]:
    n_attempts = 5
    for attempt in range(n_attempts):
        try:
            return await _fetch_file_list(model_id, revision, path, recursive)
        except HuggingFaceAuthenticationError:
            raise
        except HuggingFaceRateLimitError as e:
            if attempt == n_attempts - 1:
                raise

View on GitHub (pinned to 21a54c5ea0)

When it happens

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