cube-js/cube · error · Error

Python (loadPythonContext) is not supported because you are

Error message

Python (loadPythonContext) is not supported because you are using the fallback build of native extension. Read more: https://github.com/cube-js/cube/blob/master/packages/cubejs-backend-native/README.md#supported-architectures-and-platforms

What it means

Error "Python (loadPythonContext) is not supported because you are using the fallback build of native extension. Read more: https://github.com/cube-js/cube/blob/master/packages/cubejs-backend-native/README.md#supported-architectures-and-platforms" thrown in cube-js/cube.

Source

Thrown at packages/cubejs-backend-native/js/index.ts:647

  protected native: any | null = null;

  protected getNative(): any {
    if (this.native) {
      return this.native;
    }

    this.native = loadNative();

    return this.native;
  }

  public newJinjaEngine(options: JinjaEngineOptions): JinjaEngine {
    return this.getNative().newJinjaEngine(options);
  }

  public loadPythonContext(fileName: string, content: unknown): Promise<PythonCtx> {
    if (isFallbackBuild()) {
      throw new Error(
        'Python (loadPythonContext) is not supported because you are using the fallback build of native extension. Read more: ' +
        'https://github.com/cube-js/cube/blob/master/packages/cubejs-backend-native/README.md#supported-architectures-and-platforms',
      );
    }

    return this.getNative().pythonLoadModel(fileName, content);
  }
}

View on GitHub (pinned to 7d981676b3)

Solutions

1. Install a full native build of cubejs-backend-native matching your platform/architecture instead of the fallback build.
2. Eliminate loadPythonContext usage from the project if remaining on the fallback build.
3. See the README section on supported architectures and platforms for build availability.

When it happens

Trigger: Thrown at packages/cubejs-backend-native/js/index.ts:647 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cube-js/cube@7d981676b3 (2026-09-02). Data as JSON: /api/errors/85fdf529aa546eea. Report an issue: GitHub.