aa-contacts

What it is and what it does

aa-contacts is a Django plugin for AllianceAuth that provides a web interface for tracking standings and contacts across alliances and corporations in EVE Online. It allows users with appropriate permissions to add alliances or corporations, view their contacts and standings, edit notes, and trigger manual contact updates. The plugin integrates with AllianceAuth's permission system and can optionally integrate with the Secure Groups plugin to create smart filters based on standings—allowing administrators to grant access to users or groups based on their character's standings with specific corporations or alliances.

The plugin runs on Django 5.x, depends on allianceauth, django-esi (for EVE API access), and django-ninja (for API endpoints), and uses Celery for scheduled background updates of contact data. It supports Python 3.10 through 3.13 and is marked as production-stable. Installation is straightforward for existing AllianceAuth deployments, requiring only pip installation, configuration in local.py, and database migrations.

Use it for:

• Track standings and contact lists for multiple corporations or alliances in a single dashboard.
• Grant or restrict user access based on their character's standings with specific in-game entities via Secure Groups.
• Maintain shared notes on contacts and standings for alliance leadership and diplomacy teams.
• Automate periodic synchronization of contact data from EVE's ESI API on a schedule.

Worth the install?

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

A Django plugin for AllianceAuth that tracks and manages alliance and corporation contacts with standings, notes, and integration with the Secure Groups permission system.

Yes, if you run AllianceAuth and need centralized contact and standings management. The plugin is actively maintained, has no known vulnerabilities, and integrates cleanly with the AllianceAuth ecosystem. GPLv3 copyleft is standard for AllianceAuth plugins. Install friction is low and dependencies are well-established. Suitable for production use.

Install

aa-contacts on PyPI

pip install aa-contacts

uv add aa-contacts

poetry add aa-contacts

Installing aa-contacts

Before you install

Low install friction with a pure Python wheel. Active maintenance as of August 2026, last commit recent. Requires allianceauth, django-esi, and django-ninja as runtime dependencies.

License in practice

Licensed under GPLv3 (copyleft). Any derivative work or distribution must also be open-source under GPLv3; commercial use is permitted but modifications must be shared under the same license.

Quickstart

pip install aa-contacts==1.0.0

Add 'aa_contacts' to INSTALLED_APPS in local.py, then run:
python manage.py migrate
python manage.py collectstatic

Add the Celery task to CELERYBEAT_SCHEDULE in local.py for automatic updates.

Requires AllianceAuth installation and Django 5.x; Python 3.10 or later; Celery configuration for scheduled contact updates.

Verify before relying

• Whether Secure Groups integration is optional or required for core functionality.
• Performance characteristics when managing large numbers of contacts or corporations.
• Whether ESI rate-limiting or jitter settings require tuning for production deployments.

Package facts

Evidence: aa_contacts-1.0.0-py3-none-any.whl

Keywords: aa-contacts, allianceauth, allianceauth_contacts, contacts, eveonline

Tags

More WWW/HTTP packages