langflow-ai/langflow · error · HTTPException

An internal error occurred while loading examples.

Error message

An internal error occurred while loading examples.

What it means

Error "An internal error occurred while loading examples." thrown in langflow-ai/langflow.

Source

Thrown at src/backend/base/langflow/api/v1/flows.py:891

                starter_folder = (await session.exec(select(Folder).where(Folder.name == STARTER_FOLDER_NAME))).first()

                if not starter_folder:
                    return compress_response([])

                all_starter_folder_flows = (
                    await session.exec(select(Flow).where(Flow.folder_id == starter_folder.id))
                ).all()

                cached_flow_reads = [
                    FlowRead.model_validate(flow, from_attributes=True) for flow in all_starter_folder_flows
                ]
                _starter_flows_cache.set("starter_flows", cached_flow_reads)

            except Exception as e:
                import logging as _logging

                _logging.getLogger(__name__).exception("Error loading basic examples")
                raise HTTPException(status_code=500, detail="An internal error occurred while loading examples.") from e

        # Translate once per locale and cache the result
        # Why: cached uncompressed so the same result can be re-compressed per
        # response — keeps locale-switching working without storing per-locale
        # compressed blobs.
        translated = translate_starter_flows(cached_flow_reads, locale)
        result = []
        for flow in translated:
            flow_copy = flow.model_copy()
            if flow_copy.data and isinstance(flow_copy.data, dict):
                nodes = flow_copy.data.get("nodes", [])
                translated_nodes = translate_flow_notes(nodes, locale)
                flow_copy.data = {**flow_copy.data, "nodes": translated_nodes}
            result.append(flow_copy)

        _starter_flows_translated_cache.set(translated_cache_key, result)

    return compress_response(result)

View on GitHub (pinned to 976ec789d2)

Solutions

  1. Check server logs for the underlying error loading starter projects; a restart typically reloads the bundled examples.

When it happens

Trigger: Occurs when an unexpected internal exception is raised while loading starter/example flows.

Common situations: See trigger scenarios.


AI-assisted analysis of langflow-ai/langflow@976ec789d2 (2026-08-14). Data as JSON: /api/errors/763414546e462aba. Report an issue: GitHub.