{"id":20887,"library":"aa-contacts","title":"AA Contacts","description":"A contacts management plugin for Alliance Auth that synchronizes EVE Online contacts from ESI. Current version: 0.11.1. Released on an irregular cadence, with active maintenance.","status":"active","version":"0.11.1","language":"python","source_language":"en","source_url":"https://github.com/Maestro-Zacht/aa-contacts","tags":["allianceauth","eve-online","contacts","esi","plugin"],"install":[{"cmd":"pip install aa-contacts","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core dependency; plugin for Alliance Auth","package":"allianceauth","optional":false},{"reason":"Required for ESI integration; version >=9 is needed for v0.11.x","package":"django-esi","optional":false},{"reason":"Used for API endpoints; v0.10.x locked to <=1.4","package":"django-ninja","optional":false},{"reason":"Optional charlink hook; version >=1.13.0 needed for v0.11.0+","package":"aa-charlink","optional":true}],"imports":[{"note":"Correct import path for the main model","wrong":"","symbol":"Contacts","correct":"from aa_contacts.models import Contacts"},{"note":"A task used to trigger contact updates","wrong":"","symbol":"update_contacts_for_character","correct":"from aa_contacts.tasks import update_contacts_for_character"}],"quickstart":{"code":"# Add 'aa_contacts' to INSTALLED_APPS in your Alliance Auth settings\nINSTALLED_APPS += ['aa_contacts']\n\n# Then run migrations\n# ./manage.py migrate\n\n# In your urls.py\nfrom django.urls import path, include\nurlpatterns += [path('contacts/', include('aa_contacts.urls'))]","lang":"python","description":"Basic setup for AA Contacts in an Alliance Auth project"},"warnings":[{"fix":"Upgrade aa-charlink to >=1.13.0.","message":"v0.11.0 removed dependency on `allianceauth-app-utils`. If you use `aa-charlink`, you must upgrade to `aa-charlink>=1.13.0`. Earlier versions will not display contacts via charlink.","severity":"breaking","affected_versions":">=0.11.0"},{"fix":"Upgrade Python to 3.10 or higher.","message":"v0.10.0 dropped support for Python 3.9. Ensure your environment uses Python 3.10+.","severity":"breaking","affected_versions":">=0.10.0"},{"fix":"Expect the update to happen in the background; check back later.","message":"The new frontend (React) is default from v0.9.0. The 'Update' button triggers an asynchronous task and does not wait for completion. This is different from the old UI's synchronous behavior.","severity":"gotcha","affected_versions":">=0.9.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `pip install aa-contacts` and add 'aa_contacts' to your INSTALLED_APPS setting.","cause":"The package is not installed or the app is not in INSTALLED_APPS.","error":"ModuleNotFoundError: No module named 'aa_contacts'"},{"fix":"Double-check that INSTALLED_APPS contains 'aa_contacts' and run `./manage.py migrate`.","cause":"Typo in INSTALLED_APPS or missing migration.","error":"django.core.exceptions.ImproperlyConfigured: App with label aa_contacts could not be found"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}