---
id: apache-superset-core
version: "0.1.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# apache-superset-core — Core Python package for building Apache Superset backend extensions and integrations

License: permissive · Maintenance: active · Downloads: 400.2K/mo

## What it is and what it does

apache-superset-core is the official foundation library for extending Apache Superset with custom backend functionality. It exports decorators, base classes, and type definitions built on flask-appbuilder, sqlalchemy, pydantic, and sqlglot to reduce boilerplate when writing extensions. The package is designed for developers building Superset plugins or integrations, not for end users of Superset itself.

You install it in your extension project, inherit from its base classes, decorate your functions with provided decorators, and Superset's extension system discovers and loads your code. The package is actively maintained by the Apache Superset project and currently in alpha, meaning its API may change in future releases.

Use it for:

- Build a custom REST API endpoint in Superset to expose internal data or trigger workflows.
- Define background tasks that run asynchronously, such as report generation or data refresh jobs.
- Create MCP tools and prompts to extend Superset's integration capabilities.
- Develop a Superset plugin that adds new database connectors or visualization types.
- Integrate third-party services by writing extension code that hooks into Superset's lifecycle.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides base classes, decorators, and utilities for building Apache Superset backend extensions, including REST API endpoints, background tasks, and MCP tools.

Yes, if you are building a Superset extension or integration. The package is actively maintained, has no known vulnerabilities, and provides the official API surface for extending Superset. Be aware it is in alpha (Development Status :: 3 - Alpha), so expect potential breaking changes; pin your version and monitor releases. If you are only using Superset as an end user, you do not need this package.

## Install

pip install apache-superset-core
uv add apache-superset-core
poetry add apache-superset-core

## Installing apache-superset-core

Before you install: Low friction installation with a small, stable dependency footprint. Active maintenance with recent releases; currently in alpha status (Development Status :: 3 - Alpha), so expect API changes as the package matures.

License in practice: Apache License 2.0 (permissive) — you can use, modify, and distribute this package freely in commercial and open-source projects, provided you include the license notice and state any material changes.

Quickstart:

pip install apache-superset-core

from flask_appbuilder.api import expose, protect, safe

# Inherit from base classes and use decorators provided by the package
# to build REST API endpoints, background tasks, or MCP tools.

Requires Python 3.10 or later.

Verify before relying:

- Whether the package is stable enough for production use given its alpha status and recent first release (2025-08-27).
- Specific version constraints for runtime dependencies (flask-appbuilder, sqlalchemy, etc.) not listed in the fact sheet.
- Whether MCP (Model Context Protocol) support is fully documented and stable.
- How the package integrates with an Apache Superset deployment and what setup is required.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 400.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

superset extension framework, build superset plugins, superset backend integration, superset api decorators, superset task framework, superset mcp tools, apache superset core library, extension-framework, apache-superset, backend-integration

[View on SkillFed](https://skillfed.io/packages/apache-superset-core) · [View on PyPI](https://pypi.org/project/apache-superset-core/)