🌍 Languages / Idiomas / 语言

🚀 Features

• Transparent middleware for Django, FastAPI, Flask, WSGI and ASGI.
• Native gzip and Brotli response compression.
• Automatic Accept-Encoding negotiation.
• Correct Content-Encoding, Content-Length and Vary headers.
• Safe Python fallback when the native extension is unavailable.
• JSON utilities and runtime diagnostics.

Components and licenses

See LICENSE for the b4n1-boost license terms and the project notices for third-party license details.

📦 Installation

pip install b4n1-boost

Precompiled native wheels are provided for supported platforms; no local compiler is required when a compatible wheel is available.

🚀 Quick Start

No code rewrites. Initialize the SDK when your app starts:

Django

In your settings.py or wsgi.py:

import b4n1_boost

b4n1_boost.install_django()

FastAPI

In your main module:

from fastapi import FastAPI
import b4n1_boost

app = FastAPI()
b4n1_boost.install_fastapi(app)

Flask

In your app initialization:

from flask import Flask
import b4n1_boost

app = Flask(__name__)
b4n1_boost.install_flask(app)

Auto-detection

Let b4n1-boost detect the active framework automatically:

import b4n1_boost

b4n1_boost.autoboost()

Native compression (brotli/gzip, GIL-free)

Wrap any WSGI app (Flask, Django via WSGI, or plain WSGI) to compress large responses in Rust when the client accepts an encoding:

from b4n1_boost.middleware import B4N1BoostCompressionMiddleware

app.wsgi_app = B4N1BoostCompressionMiddleware(app.wsgi_app)

For FastAPI/Starlette use the ASGI variant:

from b4n1_boost.middleware import FastAPIBoostCompressionMiddleware

app.add_middleware(FastAPIBoostCompressionMiddleware)

Both negotiate Accept-Encoding (brotli preferred, then gzip), only compress bodies above 1 KB, set Content-Encoding, Content-Length and Vary correctly, and fall back to the untouched body when the native engine is unavailable or compression fails.

🔍 Status & Diagnostics

Check the engine state and active accelerations:

import b4n1_boost

print(b4n1_boost.status())

Expected output:

{
  "native_extension": true,
  "version": "0.1.8",
  "features": ["json_acceleration", "orm_interception", "websocket_acceleration"]
}

Run the native benchmark suite:

report = b4n1_boost.run_benchmarks(iterations=100_000)
print(f"JSON ops/sec: {report['json_bench']['ops_per_sec']:,.0f}")
print(f"ORM ops/sec:  {report['orm_bench']['ops_per_sec']:,.0f}")

🔗 Links

• Website: https://b4n1.com
• PyPI: https://pypi.org/project/b4n1-boost
• Licensing: https://b4n1.com/licensing or b4n1@b4n1.com

📄 License

This project is distributed under the Business Source License 1.1 (BSL 1.1).

• Free for development, evaluation, testing, personal projects, and startups generating under $100,000 USD in annual gross revenue.
• Commercial license required for organizations with annual gross revenue >= $100,000 USD, government agencies, and public bidding projects.
• After the Change Date (4 years), the work converts to Apache License 2.0.

See LICENSE for the full legal text.

b4n1-boost is a core component of the B4N1 sovereign computing stack, providing transparent native middleware acceleration for Python frameworks.

Built with ❤️ by the B4N1 team.