Pre-release

This release is a pre-release and may not be stable for production use.

Aikido Zen for Python 3

Zen, in-app firewall for Python 3 | by Aikido

Code Style : Black

Zen, your in-app firewall for peace of mind– at runtime.

Zen is an embedded Web Application Firewall that autonomously protects your Python apps against common and critical attacks.

Zen protects your Python apps by preventing user input containing dangerous strings, which allow SQL injections. It runs on the same server as your Python app for simple installation and zero maintenance.

Features

Zen will autonomously protect your Python applications from the inside against:

Zen operates autonomously on the same server as your Python app to:

✅ Secure your app like a classic web application firewall (WAF), but with none of the infrastructure or cost.

Supported libraries and frameworks

Zen for Python 3 is compatible with:

WSGI

✅ Django
✅ Flask ^2.2.4

WSGI Servers

✅ Gunicorn
✅ uWSGI

ASGI

✅ Django
✅ Quart
✅ Starlette ^0.16
✅ FastAPI ^0.70

Database drivers

✅ mysqlclient ^1.5
✅ PyMySQL ^0.9
✅ pymongo ^3.10
✅ psycopg2 ^2.9.2
✅ psycopg ^3.1
✅ asyncpg ^0.27
✅ motor (See pymongo version)
✅ clickhouse-driver
✅ sqlite3

AI SDKs

Zen instruments the following AI SDKs to track which models are used and how many tokens are consumed, allowing you to monitor your AI usage and costs:

✅ openai ^1.0
✅ anthropic
✅ mistralai ^1.0.0
✅ boto3 (AWS Bedrock)
✅ groq

Zen is compatible with Python 3.8-3.14 and can run on Windows, Linux, and Mac OS X.

Installation

We recommend testing Zen locally or on staging before deploying to production.

pip install aikido_zen
# or
poetry add aikido_zen
# or
uv add aikido_zen

For framework-specific instructions, check out our docs:

Guides

Troubleshooting — common issues and how to debug Zen
Set the current user — identify users for rate limiting, blocking, and attack reports
Track custom events — trigger events that Playbooks can act on
Proxy / IP headers — configure client IP detection behind load balancers
Logging — enable debug logging
Background process — how Zen's background process communicates over IPC

Reporting to your Aikido Security dashboard

Aikido is your no nonsense application security platform. One central system that scans your source code & cloud, shows you what vulnerabilities matter, and how to fix them - fast. So you can get back to building.

Zen is a new product by Aikido. Built for developers to level up their security. While Aikido scans, get Zen for always-on protection.

You can use some of Zen’s features without Aikido, of course. Peace of mind is just a few lines of code away.

But you will get the most value by reporting your data to Aikido.

You will need an Aikido account and a token to report events to Aikido. If you don't have an account, you can sign up for free.

Here's how:

Log in to your Aikido account.
Go to Zen.
Go to apps.
Click on Add app.
Choose a name for your app.
Click Generate token.
Copy the token.
Set the token as an environment variable, AIKIDO_TOKEN

Running in production (blocking) mode

By default, Zen will only detect and report attacks to Aikido.

To block requests, set the AIKIDO_BLOCK environment variable to true.

See Reporting to Aikido to learn how to send events to Aikido.

Additional configuration

Configure Zen using environment variables for authentication, mode settings, debugging, and more.

License

This program is offered under a commercial and under the AGPL license. You can be released from the requirements of the AGPL license by purchasing a commercial license. Buying such a license is mandatory as soon as you develop commercial activities involving the Zen software without disclosing the source code of your own applications.

For more information, please contact Aikido Security at this address: support@aikido.dev or create an account at https://app.aikido.dev.

Benchmarks

We run a benchmark on every commit to ensure Zen has a minimal impact on your application's performance.

See benchmarks

Bug bounty program

Our bug bounty program is public and can be found by all registered Intigriti users here

Contributing

See CONTRIBUTING.md for more information.

Code of Conduct

See CODE_OF_CONDUCT.md for more information.

Security

See SECURITY.md for more information.

Metadata

Release files for aikido-zen 1.2.37b2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aikido-zen 1.2.37b2
File	Size	Uploaded
aikido_zen-1.2.37b2.tar.gz	7.1 MB	Oct 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aikido-zen 1.2.37b2
File	Interpreter	ABI	Platform	Reset
aikido_zen-1.2.37b2-py3-none-any.whl 7.2 MB Oct 9, 2026	Python 3	none	any	Details

Total release size: 14.3 MB

Release files / aikido_zen-1.2.37b2.tar.gz

Download URL	aikido_zen-1.2.37b2.tar.gz
Size	7.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`2d1fead5dbc80c77ba0bf0a1aafa0edeb05194bcef9824d8bf4ae6e1884e2e71`
BLAKE2b-256 checksum How to use checksums	`1bd709187b4b31ed5a5d10c8570c7412b7906934c158715e7c9deaac56432d6f`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.0.1 CPython/3.12.8`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/AikidoSec/firewall-python
Publishing commit: github.com/AikidoSec/firewall-python/tree/06f46151d6f158cb62a797f9025219f9f84691bb

Workflow

Publishing configuration: github.com/AikidoSec/firewall-python/blob/06f46151d6f158cb62a797f9025219f9f84691bb/.github/workflows/publish.yml
Publishing logs: github.com/AikidoSec/firewall-python/actions/runs/37924284141/attempts/1

Artifact

Subject: aikido_zen-1.2.37b2.tar.gz
SHA-256 checksum: 2d1fead5dbc80c77ba0bf0a1aafa0edeb05194bcef9824d8bf4ae6e1884e2e71 Verifying attestations

Release files / aikido_zen-1.2.37b2-py3-none-any.whl

Download URL	aikido_zen-1.2.37b2-py3-none-any.whl
Size	7.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`6caa74a19f6981e2724bab149f36636177983057c8581e3418792c45227e5c3c`
BLAKE2b-256 checksum How to use checksums	`329db9d6b6bf5239e53a15889b543df711a5f8822559d26496e75d7352723560`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.0.1 CPython/3.12.8`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/AikidoSec/firewall-python
Publishing commit: github.com/AikidoSec/firewall-python/tree/06f46151d6f158cb62a797f9025219f9f84691bb

Workflow

Publishing configuration: github.com/AikidoSec/firewall-python/blob/06f46151d6f158cb62a797f9025219f9f84691bb/.github/workflows/publish.yml
Publishing logs: github.com/AikidoSec/firewall-python/actions/runs/37924284141/attempts/1

Artifact

Subject: aikido_zen-1.2.37b2-py3-none-any.whl
SHA-256 checksum: 6caa74a19f6981e2724bab149f36636177983057c8581e3418792c45227e5c3c Verifying attestations