Installation¶
Astra is distributed as a consolidated package under astraauth alongside three ancillary packages.
Current version: 1.0.0
Python Requirement¶
- Python
3.12+
Install the Main Package¶
To install the core library with all submodules (core, service, adapters, idp, and webauthn):
Extras & Optional Dependencies¶
You can customize your installation by choosing specific extras:
# Relational DB backends (PostgreSQL, MySQL, Redis, ZeroMQ)
pip install "astraauth[postgres,mysql,redis,zeromq]==1.0.0"
# OTP & WebAuthn support
pip install "astraauth[otp,webauthn]==1.0.0"
# Specific web framework adapters
pip install "astraauth[fastapi,flask,django,litestar,robyn]==1.0.0"
# Install everything (all database drivers, adapters, and cryptographic extras)
pip install "astraauth[otp,postgres,mysql,sql-async,redis,zeromq,webauthn,all-adapters]==1.0.0"
Install Ancillary Packages¶
Depending on your requirements, you can install the optional tools and engines separately:
1. Plugins Hub (astraauth-plugins / Astra Tantra)¶
Provides built-in plugins (like Geo/Risk filters) and re-exports core plugin hooks:
2. Operator CLI Tool (astraauth-cli / Astra Dwaar)¶
Exposes the setup wizard and CLI:
3. Browser Admin Panel (astraauth-admin-ui / Astra Netra)¶
Browser administration console:
4. ReBAC Policy Engine (astraauth-policy / Astra Niyam)¶
Zanzibar-style relationship-based access control (ReBAC) engine:
5. Multi-Tenancy Isolation (astraauth-tenancy / Astra Mandal)¶
Dynamic tenant-isolation context bindings and routing middleware:
Verify the Installation¶
Check the active version of the CLI utility:
Or verify the module entrypoint: