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.0
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
Release files for minitrino 3.1.0
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.0.tar.gz | 179.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| minitrino-3.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 403.7 kB
Release files / minitrino-3.1.0.tar.gz
| Download URL | minitrino-3.1.0.tar.gz |
|---|---|
| Size | 179.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4561ffd0866a10d40c98e6c2912fc8dc57df4b24159b19add8dbb1c311df34ba
|
|
BLAKE2b-256 checksum How to use checksums |
e4cbc84900cf0c2a0a57cfd397e4304f118e01369e7d30dae72bb106db771333
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / minitrino-3.1.0-py3-none-any.whl
| Download URL | minitrino-3.1.0-py3-none-any.whl |
|---|---|
| Size | 224.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
844eec05bfccbf775f18fb74e2a3bdadb7dbd72057e77c12534ba4e51b3a4884
|
|
BLAKE2b-256 checksum How to use checksums |
65eaff364694b8d3b670eb483debf081f525a7328c6253367ca77424cbf4ae32
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
