Minitrino
A command line tool that makes it easy to run modular Trino environments locally.
📘 Complete Documentation - User guides, API reference, and all 39 modules
Latest Stable Release: 3.1.2
What is Minitrino?
Minitrino lets you spin up complete Trino or Starburst clusters locally with minimal configuration. Mix and match from 39+ modules to create the exact environment you need:
- Catalogs: Hive, Iceberg, Delta Lake, Postgres, MySQL, ClickHouse, Elasticsearch, and more
- Security: LDAP, OAuth2, Kerberos, TLS, BIAC, password files
- Admin Tools: MinIO, Insights, Cache Service, Resource Groups, SCIM
Perfect for local development, testing configurations, learning features, and plugin development.
Compatibility
- Trino versions 443 and later
- Starburst Enterprise versions 443-e and later
Quick Start
Installation
pip install minitrino
minitrino lib-install
Run Your First Cluster
# Start a Trino cluster with Hive and Iceberg
minitrino -v provision -m hive -m iceberg
# Access the Trino UI at http://localhost:8080
# Or connect with the CLI
minitrino exec -i 'trino-cli'
Switch to Starburst
# Use Starburst with enterprise modules
minitrino -v provision -i starburst -m insights -m cache-service
Clean Up
minitrino down # Stop the cluster
minitrino remove # Remove all resources
Key Features
- 🎯 Zero Config - Start clusters with a single command
- 🔧 39+ Modules - Pre-configured catalogs, security, and admin tools
- 🐳 Docker-Based - Isolated containers, no system pollution
- 🔄 Multi-Cluster - Run multiple independent clusters simultaneously
- 🚀 Fast Setup - First provision ~5 min, subsequent provisions ~30 sec
- 📦 Both Distributions - Switch between Trino and Starburst with a flag
Development Setup
git clone https://github.com/jefflester/minitrino.git
cd minitrino
make install
source venv/bin/activate
This creates a virtual environment, installs the CLI in editable mode with dev
dependencies, and sets up pre-commit hooks. See the
Makefile for additional targets (pre-commit, unit-tests,
integration-tests, lib-tests, docs).
Documentation
Getting Started
- Installation &
Upgrades
- Install via PyPI, upgrade procedures, version compatibility
- Workflow
Examples
- Complete guide with provisioning, modules, and configuration
- CLI
Reference
- All commands, options, and flags
- Troubleshooting
- Common issues and solutions
For Developers
- Build a
Module
- Step-by-step module creation guide
- Testing
Guide
- CLI and library test documentation
- GitHub
Workflows
- CI/CD and release process
Resources
- All Modules - Browse all 39 admin, catalog, and security modules
- Environment Variables &
Config
- Configuration hierarchy and customization
- API Reference - Python API documentation
Support & Community
1 maintainer
Metadata
1 maintainer
Release files for minitrino 3.1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| minitrino-3.1.2.tar.gz | 179.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| minitrino-3.1.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 403.8 kB
Release files / minitrino-3.1.2.tar.gz
| Download URL | minitrino-3.1.2.tar.gz |
|---|---|
| Size | 179.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e780662a97527cdd66e22e116a99f08a6732e4b68198775fe718d8cb8e1c79f
|
|
BLAKE2b-256 checksum How to use checksums |
59ab6235fe146ef1248688bd5cb65334566a263a895b87dfb4392d5d661ed590
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / minitrino-3.1.2-py3-none-any.whl
| Download URL | minitrino-3.1.2-py3-none-any.whl |
|---|---|
| Size | 224.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b2c26925ce101b104e3a5c36eeee36fc59f4a222b1fa6c92e722dc1c1b5598a6
|
|
BLAKE2b-256 checksum How to use checksums |
f12140715013d9aa8509108ca5079e5ff54bc42b76a1e2d80ea7fe15c0725d52
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Security for minitrino 3.1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
