Skip to content

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):

pip install astraauth==1.0.0

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:

pip install astraauth-plugins==1.0.0

2. Operator CLI Tool (astraauth-cli / Astra Dwaar)

Exposes the setup wizard and CLI:

pip install "astraauth-cli[interactive,tui]==1.0.0"

3. Browser Admin Panel (astraauth-admin-ui / Astra Netra)

Browser administration console:

pip install astraauth-admin-ui==1.0.0

4. ReBAC Policy Engine (astraauth-policy / Astra Niyam)

Zanzibar-style relationship-based access control (ReBAC) engine:

pip install astraauth-policy==1.0.0

5. Multi-Tenancy Isolation (astraauth-tenancy / Astra Mandal)

Dynamic tenant-isolation context bindings and routing middleware:

pip install astraauth-tenancy==1.0.0


Verify the Installation

Check the active version of the CLI utility:

astra version
Or verify the module entrypoint:
python -m astraauth_cli version