---
id: aa-freight
version: "3.0.3"
license: unclear
license_treatment: unclear
maintenance: active
---

# aa-freight — An Alliance Auth app for running a freight service.

License: unclear · Maintenance: active · Downloads: 238.8K/mo

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

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

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

## Tags

alliance auth freight service, eve online courier contracts, freight pricing calculator, contract management discord, alliance logistics tracking, courier contract notifications, freight route pricing, alliance-auth-plugin, eve-online, django-app

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