Easy Django CLI

A modern CLI tool that simplifies Django development by replacing python manage.py and django-admin commands with simpler django or dj commands.

CI PyPI version Python Versions Django Versions License: MIT

Features

  • Simpler commands: Use django or dj instead of python manage.py
  • Smart project detection: Automatically finds your manage.py file
  • Drop-in replacement: Works with all Django management commands
  • Zero configuration: Just install and use

Installation

Using uv (recommended)

uv pip install easy-django-cli

Using pip

pip install easy-django-cli

Usage

After installation, you can use django or dj commands instead of python manage.py:

Before (traditional Django)

python manage.py runserver
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py shell

After (with easy-django-cli)

django runserver
django makemigrations
django migrate
django createsuperuser
django shell

Or use the even shorter dj alias:

dj runserver
dj makemigrations
dj migrate
dj createsuperuser
dj shell

How It Works

easy-django-cli automatically:

  1. Searches for manage.py in the current directory
  2. If found, executes commands through your project's manage.py
  3. If not found, falls back to django-admin for project creation and other admin commands

This means you can run Django commands from any subdirectory of your project!

Examples

Start the development server

django runserver
# or
dj runserver 0.0.0.0:8000

Create and apply migrations

django makemigrations
django migrate

Create a new Django project

django startproject myproject

Create a new app

django startapp myapp

Run tests

django test

Open Django shell

django shell

Collect static files

django collectstatic --noinput

Requirements

  • Python 3.11 or higher
  • Django 4.2 or higher

Compatibility

This package is tested with:

  • Python: 3.11, 3.12, 3.13, 3.14
  • Django: 4.2, 5.0, 5.1, 5.2, 6.0

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Tim Kamanin - A Freelance Django and Wagtail Developer

Links

Project links

Data verified by PyPI on Jun 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for timonweb from gravatar.com timonweb

Credits

Author: Tim Kamanin

GitHub Statistics

Data verified by PyPI on Jun 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

django cli command-line management tools

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

easy_django_cli-1.0.0.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

easy_django_cli-1.0.0-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

Details for the file easy_django_cli-1.0.0.tar.gz.

File metadata

  • Download URL: easy_django_cli-1.0.0.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for easy_django_cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 98968b4bce55d836092fb7cccd2fa3d8698a8f36f4fa3d59f20cd55994f76b6d
MD5 8cb9ac23d958eea715026b455f8c62c3
BLAKE2b-256 5ce1436e66f3f5721fde5c79a62670829e2061d945365c9148b39db853ca7c0e

See more details on using hashes here.

Provenance

The following attestation bundles were made for easy_django_cli-1.0.0.tar.gz:

Publisher: ci.yml on timonweb/easy-django-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file easy_django_cli-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for easy_django_cli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d37d161aeb2e4be95667ee21bb5ce0d44a78753c8079345d6dbf7be043075d42
MD5 ac33be05ebe35dcf0da8519901a7b09e
BLAKE2b-256 52d1387d3cf27e51ce9340a5dd5dbdc1d238ed6fe7bb8ad602ab5cad24a1d516

See more details on using hashes here.

Provenance

The following attestation bundles were made for easy_django_cli-1.0.0-py3-none-any.whl:

Publisher: ci.yml on timonweb/easy-django-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 files

0.2.0

2 files

0.1.2

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page