---
id: aa-killstats
version: "3.0.1"
license: GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license… (full text in the JSON record)
license_treatment: copyleft
maintenance: active
---

# aa-killstats — Killboard Stats shows Hall of Shame/Fame, Kills, Top Kills,Loss,etc.

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

## What it is and what it does

aa-killstats is a Django extension for AllianceAuth that ingests EVE Online killmail data and presents aggregated statistics for corporations and alliances. It pulls kill and loss records, maps them to player characters and their alts, and generates leaderboards (top killers, most losses, monthly rankings) plus hall of fame and shame views. The module runs scheduled tasks to fetch killmails, stores them in a local database, and uses EVE SDE data to resolve item and character IDs to human-readable names.

Installation requires configuring AllianceAuth's Django settings, running database migrations, preloading EVE SDE data, and setting up Celery beat tasks to poll for new killmails. Permissions are role-based (basic_access vs. admin_access). The package targets EVE Online community managers and alliance leadership who want in-game statistics dashboards.

Use it for:

- Display monthly kill/loss rankings and top-killer leaderboards within an alliance's internal web portal
- Track corporation performance metrics across multiple allied groups with hall of fame/shame highlights
- Generate historical kill statistics for recruitment or performance reviews of player groups
- Monitor alliance-wide combat activity trends via graphical overviews updated by scheduled killmail ingestion
- Provide role-based access so only alliance leadership can view or modify killstat settings

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Django module for AllianceAuth that tracks and displays EVE Online killboard statistics, including corporation and alliance kill/loss records, rankings, and hall of fame/shame leaderboards.

Yes, if you run an AllianceAuth instance for an EVE Online alliance or coalition. The package is actively maintained, has no known vulnerabilities, installs cleanly, and solves a real need for in-game statistics dashboards. GPLv3 licensing is standard for AllianceAuth modules. Requires AllianceAuth v5 or later and familiarity with Django configuration and Celery task setup.

## Install

pip install aa-killstats
uv add aa-killstats
poetry add aa-killstats

## Installing aa-killstats

Before you install: Low install friction with a pure-Python wheel. Actively maintained with recent commits. Requires AllianceAuth v5 or later and depends on five runtime packages including django-esi and django-eveonline-sde for EVE data integration.

License in practice: Licensed under GPLv3 (copyleft). You must share modifications under the same license and provide source code to users; suitable for internal alliance use but redistribution requires GPL compliance.

Quickstart:

pip install aa-killstats

# In AllianceAuth local.py:
INSTALLED_APPS = ["modeltranslation"] + INSTALLED_APPS
INSTALLED_APPS += ["eve_sde", "killstats"]

# Add scheduled task:
if "killstats" in INSTALLED_APPS:
    CELERYBEAT_SCHEDULE["Killstats :: Check for Killmails"] = {
        "task": "killstats.tasks.run_zkb_r2z2",
        "schedule": crontab(minute="*/1"),
    }

Requires AllianceAuth v5 or later; requires Django 4.2; requires Python 3.10 or later; requires EVE SDE data preloaded via manage.py esde_load_sde; requires Celery beat scheduler configured

Verify before relying:

- Whether the package works with AllianceAuth versions newer than v5, or if there are known compatibility constraints
- Performance characteristics when handling large killmail volumes or many corporations/alliances
- Whether the Hall of Fame and Hall of Shame features are fully implemented or still in development

## Package facts

- License: GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license… (full text in the JSON record) (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 237.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

EVE Online killboard statistics, alliance auth killstats module, corporation kill tracking, EVE kills and losses dashboard, hall of fame leaderboard, alliance kill rankings, eve-online, alliance-auth, killboard

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