django-admin-docs-llm 0.2.0

A markdown converter for Django's admin docs to make it LLM friendly.

django-admin-docs-llm

A Django pluggable app for Administrative LLM Documentation.

Installation

# Using uv
uv add django-admin-docs-llm

# Or using pip
pip install django-admin-docs-llm

Configuration

Add admindocs_llm to your INSTALLED_APPS in Django settings:

INSTALLED_APPS = [
    ...
    'admindocs_llm',
    ...
]

Include the app URLs in your project's urls.py:

from django.urls import path, include

urlpatterns = [
    ...
    path('admindocs/', include('admindocs_llm.urls')),
    ...
]

Development

Setup

# Clone the repository
git clone <repository-url>
cd django-admin-docs-llm

# Install dependencies with test extras
uv sync --extra test

Running Tests

# Run all tests
./runtests.sh

# Run with coverage
./runtests.sh --cov=admindocs_llm

# Run specific test file
./runtests.sh tests/test_app.py

Test Django Server

# Run migrations
./manage.sh migrate

# Create superuser
./manage.sh createsuperuser

# Run development server
./manage.sh runserver

Then visit http://localhost:8000/admin/ and http://localhost:8000/admindocs/

See tests/README.md for more details about the test project.

Settings

ADMINDOCS_LLM_EXCLUDE_APPS

By default, all django.contrib.* apps are excluded from the LLM documentation output (models, views, tags, filters) since LLMs already know Django's built-in components.

# Override to exclude only specific apps
ADMINDOCS_LLM_EXCLUDE_APPS = ['admin', 'auth', 'contenttypes']

# Disable filtering entirely (show everything)
ADMINDOCS_LLM_EXCLUDE_APPS = []

Requirements

• Python >= 3.10
• Django >= 4.2
• markitdown >= 0.1.4

License

MIT