django-admin-agent

An always-present chat-agent sidebar embedded in the Django admin. The agent reads your data through typed, server-side tools and drives the admin UI — filling forms, applying filters, navigating between pages — with visible animations and a confirmation modal on anything destructive.

It builds on django-ag-ui (the Django ↔ Pydantic-AI ↔ AG-UI bridge) and ships the @artooi/ag-ui-web-component <ag-ui-chat> element vendored as a static bundle — there's no separate npm install. Works with the vanilla Django admin and with Django Unfold.

Server-side admin tools — a default registry of read-only shell.* (query / count / fetch instances) and introspect.* (model schema, admin registration) tools, derived from your installed models. Every call is typed and audited through django-ag-ui's AuditLogger.
Frontend tool handlers — nav.* and DOM-driving tools (fill a field, click, apply a changelist filter) execute in the browser against the live admin page, with animations so the user sees what the agent is doing.
Destructive-action gating — tools flagged x-destructive in their JSON Schema are intercepted by a confirmation modal before they run.
Drop-in sidebar — a {% django_admin_agent_sidebar %} template tag (no admin-site swap) or a SidebarAdminSite for those who prefer to subclass.
Themeable, with skills — configure the theme (light / dark / auto / code), density, placement, text animation, and tool-call display mode from DJANGO_ADMIN_AGENT, and surface a catalog of one-click skills as composer chips and a /-command palette. Built on django-ag-ui>=0.17,<0.19 and the matching @artooi/ag-ui-web-component.
Voice & model thoughts — set DJANGO_AG_UI["TRANSCRIPTION_BACKEND"] to add a 🎤 mic to the composer (server-side transcription), and a reasoning model's streamed chain-of-thought renders in a collapsible "thoughts" region. Both ride on the re-vendored web component; voice is off until a backend is configured.
Unfold-aware — a runtime JS shim adapts the sidebar to Unfold's chrome; any Python Unfold introspection is lazy and guarded, so Unfold stays optional.
100% test coverage, type-checked, Python 3.10–3.14, Django 4.2–6.0.

📖 Full documentation: https://artui.github.io/django-admin-agent/

pip install django-admin-agent
# expose the admin tools as an HTTP MCP server too:
pip install "django-admin-agent[mcp]"

ASGI required. The agent endpoint streams Server-Sent Events, which the sync WSGI worker can't serve — deploy the admin under Daphne / Uvicorn.

Quick start

# settings.py
INSTALLED_APPS = [
    # ...
    "django.contrib.admin",
    "django_admin_agent",
]

# urls.py
from django.contrib import admin
from django.urls import path

from django_admin_agent import AdminAgentServer

urlpatterns = [
    path("admin/", admin.site.urls),
    # Mounts the agent server over the default shell.* + introspect.* registry.
    path("admin-agent/", AdminAgentServer(model="anthropic:claude-sonnet-4.6").urls),
]

{# templates/admin/base_site.html — override so it wins over the admin app's copy #}
{% extends "admin/base.html" %}
{% load django_admin_agent %}

{% block branding %}
  <h1 id="site-name"><a href="{% url 'admin:index' %}">My admin</a></h1>
  {% django_admin_agent_sidebar %}
{% endblock %}

That's the whole wiring: the template tag computes its own context (endpoint URL, title, auto-confirm flag, bootstrap module, route map), so the admin site doesn't need swapping. Serve it over ASGI:

uvicorn myproject.asgi:application

The model can be set per-mount (AdminAgentServer(model=...)) or globally via DJANGO_AG_UI["MODEL"]. See the docs for the full tool surface, configuration reference, the SidebarAdminSite path, Unfold support, and the [mcp] server.

License

MIT — see LICENSE.

Download files

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

Source Distribution

django_admin_agent-0.16.1.tar.gz (265.6 kB view details)

Uploaded Aug 8, 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.

django_admin_agent-0.16.1-py3-none-any.whl (137.5 kB view details)

Uploaded Aug 8, 2026 Python 3

File details

Details for the file django_admin_agent-0.16.1.tar.gz.

File metadata

Download URL: django_admin_agent-0.16.1.tar.gz
Upload date: Aug 8, 2026
Size: 265.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_admin_agent-0.16.1.tar.gz
Algorithm	Hash digest
SHA256	`5f760599f52d1ff3bfa3acd6f373fadf40142f4a50b80b0eea33ed8504b56bda`
MD5	`2e07899f61f39f7dc554fe03dcf42a32`
BLAKE2b-256	`8696b809b0a49aa1ff6dbf916ab218dca67d9f7d324bd767e0065143dea79e13`

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_admin_agent-0.16.1.tar.gz:

Publisher: release.yml on Artui/django-admin-agent

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: django_admin_agent-0.16.1.tar.gz
- Subject digest: 5f760599f52d1ff3bfa3acd6f373fadf40142f4a50b80b0eea33ed8504b56bda
- Sigstore transparency entry: 2382213246
- Sigstore integration time: Aug 8, 2026
Source repository:
- Permalink: Artui/django-admin-agent@9f6d7c82ebccf7b55f82ebb653bc22d3a2a5f261
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Artui
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@9f6d7c82ebccf7b55f82ebb653bc22d3a2a5f261
- Trigger Event: push