Flask-Squeeze is a Flask extension that automatically:

• Minifies responses with JavaScript, CSS, and HTML content
• Compresses all responses with brotli (preferred), gzip, or deflate compression based on browser support
• Protects against the BREACH exploit by adding random padding to compressed responses
• Caches static files so they don't need to be re-compressed, with both in-memory and persistent disk caching options
• Optimizes performance with intelligent compression levels for static vs. dynamic content
• Works out-of-the-box - no changes needed to your existing Flask routes or templates

Files are considered static if the substring "/static/" is in their request path.

• Compatibility
• Installation
• Quick Start
• Contributing

• Works with Python 3.9 to 3.14

pip install Flask-Squeeze

from flask import Flask
from flask_squeeze import Squeeze
squeeze = Squeeze()

def create_app():
    app = Flask(__name__)

    # Init Flask-Squeeze
    squeeze.init_app(app)

    # Init all other extensions
    # AFTER Flask-Squeeze

    return app

Thats it! The responses of your Flask app will now get minified and compressed, if the browser supports it. To control how Flask-Squeeze behaves, the following options exist:

app.config.update({
    'SQUEEZE_CACHE_DIR': './cache/flask_squeeze/',  # Enable persistent caching
    'SQUEEZE_MIN_SIZE': 1000,  # Only compress files > 1KB
    'SQUEEZE_VERBOSE_LOGGING': True,  # Debug mode
})

1. Report bugs by opening an issue
2. Submit pull requests with improvements
3. Improve documentation

git clone https://github.com/mkrd/Flask-Squeeze.git
cd Flask-Squeeze
uv sync
just test  # Run tests
just run-test-app  # Run test app

MIT License - see LICENSE file for details.