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.1
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.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| minitrino-3.1.1.tar.gz | 179.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| minitrino-3.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 403.7 kB
Release files / minitrino-3.1.1.tar.gz
| Download URL | minitrino-3.1.1.tar.gz |
|---|---|
| Size | 179.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b76eda8edca44abf3f9012f1a428298bad26d65d69cf1747029b4045f3ca00a9
|
|
BLAKE2b-256 checksum How to use checksums |
aab33e0e7e717235a5905b945c2a77fcbbe6b92f418ad85f4e2a8139cd827bff
|
| 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.1-py3-none-any.whl
| Download URL | minitrino-3.1.1-py3-none-any.whl |
|---|---|
| Size | 224.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
21a7bf3826cba81b647b97208b3244e4f317190bb00189db15d93e19ffcd8e4c
|
|
BLAKE2b-256 checksum How to use checksums |
c5a3fab7ef1ea2b37579fa5f92475c4b890981c3d094c22f227851efc3bd1399
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
