Developer Edition

The StrataBI Developer Edition is a way to run StrataBI locally on your own machine — a plain Python process, not a hosted deployment — wired to a real AWS data plane in your own account. It is built for developers who want to build and test modules, author dashboards, or do ad-hoc analytics without standing up the full hosted runtime.

For step-by-step setup (Python, AWS credentials, OpenTofu, per-OS), follow the Installation Guide; this page explains what the edition is and how it differs from the Enterprise Edition.

It is source-available under the Shaleio Guild Community License (SGCL): you can read the code, run it, modify it, and use it for your own development and internal work. It is not an OSI-approved open-source license; see the license for what's permitted.

What it is

You install the stratabi package (with pipx, or from source), point it at your AWS credentials, and run the app — it serves the StrataBI interface on localhost:8050. Queries still execute on Athena, compute still extends through Lambda modules, and artifacts still land in S3 — all in your account. The only thing that changes is where the runtime process runs: your laptop (or an AWS WorkSpaces desktop / CloudShell session) instead of a managed container.

text

your machine (stratabi, localhost:8050)
        │  boto3 — your AWS credentials
        ▼
your AWS account:  S3 · Athena · Glue · Lambda · DynamoDB

A landing page orients you when the app starts; from there the Builder authors dashboards and the Dashboard page runs them.

What it's for

Module development & testing — build a module against a real data plane and iterate locally.
Dashboard authoring — write and preview declarative dashboard JSON in the builder.
Ad-hoc analytics — run StrataBI for your own internal use without a full install.

How it differs from a full deployment

The Developer Edition is intentionally slim. It drops the pieces that only make sense in a shared, hosted install — the admin console, the AI home page, role-based access control, and the favorites/pinned dashboard overlays — leaving the dashboard runtime, the builder, and the module execution path. Deployment patterns reserved for the hosted edition, such as running the runtime on managed application hosting, are not part of this edition.

You provision the AWS data plane (S3, Athena, Lambda, DynamoDB) once with the included Terraform / OpenTofu, then run the app locally against it. See the Quickstart and Deploy pages for the mechanics.

Install it

Install the runtime with pipx (from PyPI):

bash

pipx install stratabi
stratabi --check     # preflight: dependencies, AWS creds/region, settings
stratabi             # serve http://127.0.0.1:8050

The source is on GitHub — read it, fork it, open issues. To have the AWS data plane provisioned for you, also install the StrataCTL orchestrator (pipx install stratactl); see Deploy the data plane below.

Packages & source

StrataBI Developer Edition — PyPI: stratabi ·

GitHub: shaleio/stratabi-dev

StrataCTL (installer/orchestrator) — PyPI: stratactl ·

GitHub: shaleio/stratactl

See it in 30 seconds — the ForgeWorks demo

The fastest way to understand StrataBI is the built-in ForgeWorks Quick Demo — a synthetic dataset baked into a live dashboard, with no AWS required:

bash

stratabi demo quick

When you're ready to see the real Athena-backed path, stratactl dev demo install uploads the same data to your account and queries it through Athena. See the StrataCTL guide.

Deploy the data plane

The runtime needs a small AWS data plane (S3 / Athena / Glue / DynamoDB) in your account. Stand it up either with the CLI —

bash

pipx install stratactl
stratactl --profile <aws-profile> --region <region> bootstrap --run        # one-time: StrataCI
stratactl --profile <aws-profile> --region <region> dev install            # deploy the data plane
stratactl --profile <aws-profile> --region <region> dev configure-local    # write a non-secret .env
stratabi                                                                   # run the app

(--profile/--region may appear anywhere in the command. dev install is the Developer Edition surface of the shared install path — the equivalent one-shot form is stratactl install-stratabi-dev; see the StrataCTL guide.)

dev configure-local reads the install's outputs and writes the STRATABI_* settings (system bucket, Athena output, catalog database, table names) plus AWS_PROFILE, AWS_REGION, and AWS_DEFAULT_REGION into a local .env — no AWS keys. The app loads that .env at startup; stratabi --check confirms everything resolves.

Or stand the data plane up by hand with the included OpenTofu/Terraform (git clone, then tofu apply in infra/, and copy the env_file_preview output into .env). Both paths are HQ-free; see the Quickstart and Deploy pages. Load ForgeWorks into your account anytime with stratactl dev demo install.

Versioning

Shaleio versions are Major.Sprint.Patch (not SemVer): the middle number is the shared 2-week sprint the release was cut in, so it lines up across every Shaleio project. Valid MAJOR.MINOR.PATCH triples, so pip/pipx handle them normally.