aa-structures

What it is and what it does

aa-structures is a Django plugin for Alliance Auth that centralizes management and monitoring of Eve Online in-game structures owned by member corporations. It syncs structure data (Upwell structures, starbases, customs offices) from the Eve Online ESI API and displays them in a searchable, permission-controlled browser within Alliance Auth. The app automatically forwards relevant in-game notifications—fuel warnings, sovereignty events, war declarations, moon mining activity—to Discord channels as alerts, and can populate structure timer boards with critical events.

The package depends on a working Alliance Auth deployment plus 10 runtime packages including django-esi for API access, redis-simple-mq for task queuing, and dhooks-lite for Discord integration. It supports Python 3.10+ and Django 4.2 or 5.2. Installation is straightforward if you already run Alliance Auth, but the app is tightly coupled to that ecosystem and requires ESI token management and Discord webhook configuration.

Use it for:

• Display a real-time inventory of all structures owned by your alliance's member corporations in one searchable interface.
• Automatically alert Discord channels when structures run low on fuel or face reinforcement timers.
• Track customs office tax rates and access settings across your territory.
• Populate Alliance Auth's structure timer board with critical events extracted from game notifications.
• Monitor sync health and ESI token validity across multiple structure-owning accounts.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Django app that integrates with Alliance Auth to display, track, and monitor Eve Online in-game structures (Upwell structures, starbases, customs offices) and forwards game notifications to Discord.

Yes, if you operate an Alliance Auth deployment and need centralized structure visibility and Discord alerting for your Eve Online alliance. The active maintenance, low install friction, and lack of known vulnerabilities support adoption. However, verify the license terms first (currently unclear in metadata) and ensure your Alliance Auth infrastructure is already in place—this is not a standalone tool.

Install

aa-structures on PyPI

pip install aa-structures

uv add aa-structures

poetry add aa-structures

Installing aa-structures

Before you install

Low install friction with a pure-Python wheel. Active maintenance as of 2026-07-18. Requires 10 runtime dependencies including allianceauth, django-esi, and redis-simple-mq, so installation complexity depends on your existing Alliance Auth setup.

License in practice

License status is unclear—no SPDX identifier or raw license text is declared in the package metadata. Verify the actual license terms in the repository before adopting this package in a commercial or restricted-use context.

Quickstart

pip install aa-structures

Then add 'structures' to INSTALLED_APPS in your Alliance Auth Django settings and configure it with your Eve Online ESI credentials and Discord webhook details.

Requires an existing Alliance Auth installation (Django 4.2 or 5.2) and Python 3.10+. Also requires redis-simple-mq and valid Eve Online ESI tokens to sync structure data.

Verify before relying

• Exact scope of structure types and game notifications supported beyond those listed in the description.
• Whether the BETA features (refuel notifications, POS reinforced alerts) are production-ready.
• Performance characteristics when managing large numbers of structures across many corporations.

Package facts

Evidence: aa_structures-4.0.3-py3-none-any.whl

Tags

More WWW/HTTP packages