---
id: django-eveuniverse
version: "2.1.0"
license: unclear
license_treatment: unclear
maintenance: active
---

# django-eveuniverse — Complete set of Eve Universe models with on-demand loading from ESI.

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

## What it is and what it does

django-eveuniverse is a Django app that mirrors Eve Online's universe structure as a set of database models—regions, solar systems, types, planets, and more—all queryable as standard Django ORM objects. It bridges the gap between Eve's ESI API and a local database, letting you work with universe data as if it were already in your schema.

The package's main value is its on-demand loading mechanism: when you request an Eve object that isn't yet in your database, it fetches it from ESI automatically. It also provides management commands to preload common datasets (like the full map or all ship types), a special EveEntity model for resolving Eve IDs to character/corporation/alliance names, and optional async loading of related objects. This makes it a foundation layer for building Eve Online companion apps without having to design the universe schema yourself.

Use it for:

- Build an Eve Online companion app that needs to display or query universe data (regions, systems, types) without managing the schema.
- Resolve Eve Online entity IDs (characters, corporations, alliances) to names using the EveEntity model.
- Preload and cache frequently accessed universe data (ship types, regions) to reduce ESI API calls.
- Implement solar system routing or pathfinding features using the preloaded map data.
- Develop alliance tools that need to correlate player actions with universe locations and item types.

## Worth the install?

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

Provides Django models for Eve Online universe data with on-demand loading from ESI, including regions, types, planets, and entity resolution.

Yes, if you are building an Eve Online Django app and need a ready-made universe data layer. The package is actively maintained, has low install friction, and covers a real gap in Eve tooling. Verify the license before using in proprietary work, and ensure your ESI credentials and django-esi setup are in place. Not relevant for non-Eve projects.

## Install

pip install django-eveuniverse
uv add django-eveuniverse
poetry add django-eveuniverse

## Installing django-eveuniverse

Before you install: Low install friction with a wheel distribution. Active maintenance as of late July 2026. Depends on celery, django-esi, django-bitfield, and other common Django ecosystem packages; no unusual compilation or system dependencies noted.

License in practice: License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before using in proprietary or copyleft-sensitive projects.

Quickstart:

pip install django-eveuniverse

from eveuniverse.models import EveType, EveRegion

# Fetch a type on-demand from ESI
type_obj = EveType.objects.get_or_create_esi(id=1)

# Query preloaded regions
regions = EveRegion.objects.all()

Requires Django 4.2 or later and Python 3.10+; ESI API access and django-esi configuration are needed for on-demand loading.

Verify before relying:

- Whether the package includes a route-finding algorithm or delegates to external libraries for solar system routing.
- Scope and performance characteristics of the optional asynchronous loading for related children.
- Whether preloading management commands are documented and which datasets they cover beyond 'map' and 'ships types'.

## Package facts

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

## Tags

eve online django models, eve universe esi integration, eve online data django, eve entity resolution, eve universe preloading, eve solar system routing, eve online app framework, eve-online, esi-integration, game-data

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