---
id: superset-showtime
version: "0.7.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# superset-showtime — 🎪 Apache Superset ephemeral environment management with circus tent emoji state tracking

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

## What it is and what it does

Superset Showtime is a CLI tool that automates the lifecycle of ephemeral Apache Superset testing environments. It uses GitHub PR labels as a visual state machine—users add emoji-labeled trigger labels (like 🎪 ⚡ showtime-trigger-start) to request environment creation, and the tool responds by updating labels to show build progress, deployment status, and the environment's IP address. It integrates with GitHub Actions to detect commits, build Docker images, and deploy them to AWS with zero-downtime blue-green deployments.

The tool handles the full environment lifecycle: building Docker images, deploying to AWS, managing state transitions, and cleaning up resources when done. It supports freezing environments to test specific commits without auto-updating on new pushes, and automatically rolls out new environments when commits are pushed. The label-based state system makes environment status visible directly in the GitHub UI without requiring external dashboards.

Use it for:

- Superset maintainers testing PRs in isolated environments without manual AWS provisioning or cleanup.
- Developers validating configuration changes by triggering environment creation with modified superset_config.py.
- Testing specific commits by freezing an environment to prevent auto-updates while continuing development.
- Automating blue-green deployments in CI/CD pipelines with automatic traffic switching and old environment cleanup.
- Debugging environment state and deployment issues using CLI commands like showtime status and showtime list.

## Worth the install?

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

A CLI tool that manages ephemeral Apache Superset environments in GitHub Actions using emoji-labeled state tracking, automating Docker builds and AWS deployments with zero-downtime rolling updates.

Yes, if you are a Superset maintainer or contributor using GitHub Actions and AWS. The tool solves a specific, well-defined problem—automating ephemeral environment management with minimal operational overhead. Low install friction, no vulnerabilities, and active maintenance make it safe to adopt. Not relevant for users outside the Superset ecosystem or those not using GitHub Actions and AWS.

## Install

pip install superset-showtime
uv add superset-showtime
poetry add superset-showtime

## Installing superset-showtime

Before you install: Low friction: pure Python wheel with no compiled dependencies. Actively maintained (latest release 2026-06-28, 47 days old). Supports Python 3.8–3.12. Depends on well-established libraries (boto3, pydantic, typer, rich) with no known vulnerabilities.

License in practice: Apache-2.0 permissive license: you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install superset-showtime
export GITHUB_TOKEN=your_token
showtime sync PR_NUMBER              # Sync to desired state
showtime list                        # List all active environments

Requires GITHUB_TOKEN environment variable set and AWS credentials configured (boto3 will look for them in standard locations). Intended for use in GitHub Actions or by developers with AWS access.

Verify before relying:

- Whether the package works outside GitHub Actions contexts or requires GitHub-specific setup beyond the token.
- Cost implications of AWS resource creation and cleanup behavior under various failure scenarios.
- How the package handles concurrent requests or race conditions when multiple PRs trigger simultaneously.

## Package facts

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

## Tags

ephemeral environment management, github actions superset deployment, aws environment automation, docker build and deploy cli, zero-downtime blue-green deployment, github label state machine, superset testing environments, github-actions, aws-deployment, ephemeral-environments

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