dj-control-room

Django Control Room

A framework for building Django admin tools and a growing suite of operational panels for your project.

Django Control Room is a plugin framework for building Django admin tools (called "panels"), and a suite of official panels for services like Redis, Celery, and caches, plus Django internals like URLs and Signals. Every panel, official or third-party, is a small independent Python package built on the public plugin API in dj-control-room-base.

Install dj-control-room and it discovers compatible panels via Python entry points, renders them in a centralized dashboard, and gives them a shared design system, permissions model, and admin sidebar integration.

Django Control Room Dashboard

Features

Plugin framework - build admin tools on dj-control-room-base; custom panels behave like the official ones
Centralized dashboard - installed panels are discovered automatically and shown in one place
Shared UI - responsive design and dark mode via a common design system; theme adapters for popular admin skins
Secure - package verification and staff-gated access
Official panels - pre-built panels for common operational tasks
AI agent integration (MCP) - one MCP endpoint aggregates every installed panel's tools (see Configuration)

Quick start

# Core only
pip install dj-control-room

# With specific official panels
pip install dj-control-room[redis,cache,urls]

# Or with all official panels
pip install dj-control-room[all]

Add dj_control_room_base (required core library), your panels, then dj_control_room (so they appear under one admin section):

INSTALLED_APPS = [
    # ...
    "dj_control_room_base",
    "dj_redis_panel",
    "dj_cache_panel",
    "dj_urls_panel",
    "dj_control_room",
]

urlpatterns = [
    path("admin/dj-redis-panel/", include("dj_redis_panel.urls")),
    path("admin/dj-cache-panel/", include("dj_cache_panel.urls")),
    path("admin/dj-urls-panel/", include("dj_urls_panel.urls")),
    path("admin/dj-control-room/", include("dj_control_room.urls")),
    path("admin/", admin.site.urls),
]

python manage.py migrate

Then visit http://localhost:8000/admin/dj-control-room/.

For the full walkthrough, settings (sidebar behavior, MCP), and theme adapters, see Installation, Configuration, and Theme Adapters.

Official panels

Panel	Description	Install
Redis Panel	Monitor connections, inspect keys, view memory usage	`pip install dj-redis-panel`
Cache Panel	Inspect cache entries, view hit/miss ratios	`pip install dj-cache-panel`
URLs Panel	Browse URL patterns, test resolvers	`pip install dj-urls-panel`
Celery Panel	Monitor workers, track task queues	`pip install dj-celery-panel`
Signals Panel	Inspect Django signals and receivers	`pip install dj-signals-panel`

Creating custom panels

pip install cookiecutter
cookiecutter https://github.com/django-control-room/cookiecutter-dj-control-room-plugin

For a full guide, see Creating Panels or the build your own panel walkthrough.

Documentation

Official site: djangocontrolroom.com
Full docs: django-control-room.github.io/dj-control-room

Page	Contents
Installation	Install, `INSTALLED_APPS`, URLs
Configuration	Settings, sidebar, CSS, MCP
Scopes	Permission scopes
Theme Adapters	Supported admin skins and screenshots
Creating Panels	Build custom panels
API Reference	Public API

Requirements

Python 3.9+
Django 4.2+

Contributing

See the Contributing Guide.

License

MIT. See LICENSE.

Credits

Created by Yasser Toruno

Official Site · GitHub · Issues

Download files

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

Source Distribution

dj_control_room-1.7.1.tar.gz (1.4 MB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dj_control_room-1.7.1-py3-none-any.whl (1.4 MB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file dj_control_room-1.7.1.tar.gz.

File metadata

Download URL: dj_control_room-1.7.1.tar.gz
Upload date: Aug 11, 2026
Size: 1.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dj_control_room-1.7.1.tar.gz
Algorithm	Hash digest
SHA256	`d9ff66f74c7d11ffbab8ebc30c6404783660de47995256aa4eb2e5fc2403e848`
MD5	`1322b465271015b126fc223efc3a7784`
BLAKE2b-256	`3f35b5dc9e52593661486ccbb95e3b848f093cef1b8de509289776a21e4a9544`

See more details on using hashes here.

Provenance

The following attestation bundles were made for dj_control_room-1.7.1.tar.gz:

Publisher: python-publish.yml on django-control-room/dj-control-room

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: dj_control_room-1.7.1.tar.gz
- Subject digest: d9ff66f74c7d11ffbab8ebc30c6404783660de47995256aa4eb2e5fc2403e848
- Sigstore transparency entry: 2424137547
- Sigstore integration time: Aug 11, 2026
Source repository:
- Permalink: django-control-room/dj-control-room@8a159a1f4f7333583432b03eb7371792e4551796
- Branch / Tag: refs/tags/1.7.1
- Owner: https://github.com/django-control-room
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@8a159a1f4f7333583432b03eb7371792e4551796
- Trigger Event: release