aa-freight

What it is and what it does

aa-freight is a Django application plugin for Alliance Auth that automates the operation of a central freight/courier service for Eve Online alliances and corporations. It provides contract tracking, pricing management across multiple routes, and reward calculation for freight pilots. The app pulls contract data from the Eve Online ESI API via a designated character handler and displays outstanding contracts with compliance checks against configured pricing.

The package integrates Discord webhooks for real-time notifications to pilots about new contracts and to customers about contract status updates. It includes a statistics dashboard showing performance metrics by route, pilot, and customer, and supports both English and German language interfaces. Core functionality depends on Celery for periodic contract synchronization and requires Django 4.2 or 5.2 running on Python 3.10 or later.

Use it for:

• Run a centralized freight service for an alliance by defining routes, pricing, and automatically notifying pilots of new contracts via Discord.
• Calculate correct courier rewards using the built-in calculator to ensure pricing compliance across multiple bidirectional routes.
• Monitor contract status and performance metrics across pilots and customers to optimize freight service operations.
• Send automated Discord notifications to contract issuers tracking the status and development of their courier contracts.
• Manage freight operations outside the alliance structure by configuring the app for corporation-run services with custom permissions.

Worth the install?

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

An Alliance Auth app that manages a central freight service for alliances or corporations, including contract tracking, reward calculation, route pricing, and Discord notifications.

Yes, if you run an Alliance Auth instance and need freight service management. The package is actively maintained, has no known vulnerabilities, and integrates cleanly with the Alliance Auth ecosystem. However, verify the license terms in the repository first, as the package metadata does not declare a license. Requires Celery and ESI configuration, so it is not suitable for standalone use.

Install

aa-freight on PyPI

pip install aa-freight

uv add aa-freight

poetry add aa-freight

Installing aa-freight

Before you install

Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (18 days old) and no known vulnerabilities. Requires six runtime dependencies including allianceauth and django-esi, all standard for Alliance Auth ecosystem apps.

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 deploying to production.

Quickstart

pip install aa-freight

# In Alliance Auth settings (local.py):
INSTALLED_APPS += ['freight']

CELERYBEAT_SCHEDULE['freight_run_contracts_sync'] = {
    'task': 'freight.tasks.run_contracts_sync',
    'schedule': 600,
}

# Then run:
python manage.py migrate
python manage.py collectstatic

Requires an active Alliance Auth installation with Django 4.2 or 5.2, Python 3.10+, and Celery configured for background task execution. ESI scopes esi-universe.read_structures.v1 and esi-contracts.read_corporation_contracts.v1 must be added to your Eve Online app.

Verify before relying

• Exact license terms and conditions—metadata shows unclear treatment with no SPDX or raw license field populated.
• Whether Discord Proxy integration is required for core functionality or optional for notifications only.
• Performance and scalability characteristics when handling large numbers of contracts or routes.

Package facts

Evidence: aa_freight-3.0.3-py3-none-any.whl

Tags

More WWW/HTTP packages