---
id: aa-contacts
version: "1.0.0"
license: unclear
license_treatment: copyleft
maintenance: active
---

# aa-contacts — Contacts tool for AllianceAuth

License: copyleft · Maintenance: active · Downloads: 236.9K/mo

## 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 above — 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

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

- License: not declared (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 236.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

allianceauth contacts plugin, eve online standings tracker, corporation alliance management, django contact standings, allianceauth secure groups filter, eve contacts tool, allianceauth-plugin, eve-online, standings-management

[View on SkillFed](https://skillfed.io/packages/aa-contacts) · [View on PyPI](https://pypi.org/project/aa-contacts/)