Welcome to FlavorPack¶
Initial release Software - Development Version
FlavorPack is currently in early initial release. APIs, file formats, and commands may change without notice. Not recommended for production use. Check current version with flavor --version. Install with uv tool install flavorpack, then run make build-helpers.
FlavorPack is a cross-language packaging system that creates self-contained, portable executables using the Progressive Secure Package Format (PSPF/2025). Ship Python applications as single binaries that work without installation, dependencies, or configuration.
๐ค AI-Generated Content
This documentation was generated with AI assistance and is still being audited. Some, or potentially a lot, of this information may be inaccurate. Learn more.
-
Get Started Quickly
Package your first application in under 5 minutes.
-
Single-File Distribution
Package applications into one executable that runs anywhere.
-
Secure by Default
Ed25519 signature verification ensures integrity.
-
Cross-Language
Python orchestrator with native Go and Rust launchers.
What is FlavorPack?¶
FlavorPack transforms Python applications into self-contained executables using the Progressive Secure Package Format (PSPF/2025). Each package contains the application code, Python runtime, dependencies, and a native launcher - all in a single .psp file.
Key Features: - Single-file distribution - Cryptographic security (Ed25519 signatures) - Smart caching with validation - Cross-platform (Linux, macOS, Windows) - Zero dependencies required - Native performance (Go/Rust launchers)
Quick Example¶
# Package a Python application
flavor pack --manifest pyproject.toml --output myapp.psp
# Run the packaged application (no Python required)
./myapp.psp
# Verify package integrity
flavor verify myapp.psp
Part of the provide.io Ecosystem¶
This project is part of a larger ecosystem of tools for Python and Terraform development.
Understand how provide-foundation, pyvider, flavorpack, and other projects work together.
Use Cases¶
Ideal for
- CLI Tools: Distribute command-line applications without Python installation
- Data Science: Package ML models with their environment
- DevOps: Deploy self-contained tools that work everywhere
- Enterprise: Secure, signed packages with built-in verification
- Terraform: Package custom providers as single executables
Platform Support¶
Community¶
- GitHub: Issues and pull requests
- Documentation: Guides and API reference
- Support: Get help
Ready to package your Python applications? Check out our Quick Start guide or explore the architecture.