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.37

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.37
File	Size	Uploaded
aikido_zen-1.2.37.tar.gz	7.1 MB	Oct 15, 2026	Details

Built distribution (wheel)

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

Total release size: 14.3 MB

Release files / aikido_zen-1.2.37.tar.gz

Download URL	aikido_zen-1.2.37.tar.gz
Size	7.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`819af89ab7465eb2867d7b8bf5c14838df544e45a7185500704c1cd204d76171`
BLAKE2b-256 checksum How to use checksums	`191ca0ea655819be4498f4d9109e4121177edec646407a1a080f0abc1abe6e61`
Upload date	Oct 15, 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/30c7d2141dc4a476d5964e38fa931fd41c2334b6

Workflow

Publishing configuration: github.com/AikidoSec/firewall-python/blob/30c7d2141dc4a476d5964e38fa931fd41c2334b6/.github/workflows/publish.yml
Publishing logs: github.com/AikidoSec/firewall-python/actions/runs/38709343625/attempts/1

Artifact

Subject: aikido_zen-1.2.37.tar.gz
SHA-256 checksum: 819af89ab7465eb2867d7b8bf5c14838df544e45a7185500704c1cd204d76171 Verifying attestations

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

Download URL	aikido_zen-1.2.37-py3-none-any.whl
Size	7.2 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`ced8dac7605cfc49fc6fb5f879a7e899298e9f89b873c0048f5685babe3bafec`
BLAKE2b-256 checksum How to use checksums	`c316db3394487e222da0feefb1c456dafb00938b1869974cc84803cdbe17cf34`
Upload date	Oct 15, 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/30c7d2141dc4a476d5964e38fa931fd41c2334b6

Workflow

Publishing configuration: github.com/AikidoSec/firewall-python/blob/30c7d2141dc4a476d5964e38fa931fd41c2334b6/.github/workflows/publish.yml
Publishing logs: github.com/AikidoSec/firewall-python/actions/runs/38709343625/attempts/1

Artifact

Subject: aikido_zen-1.2.37-py3-none-any.whl
SHA-256 checksum: ced8dac7605cfc49fc6fb5f879a7e899298e9f89b873c0048f5685babe3bafec Verifying attestations