Metadata-Version: 2.4
Name: django-agentweb
Version: 0.1.0
Summary: Make Django sites first-class citizens of the agentic web: llms.txt, Schema.org/JSON-LD, agent discovery, WebMCP tools, agentic commerce/booking and SDF — per-site opt-in.
Home-page: https://github.com/DLRSP/django-agentweb
Author: DLRSP
Author-email: DLRSP <dlrsp.dev@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/DLRSP/django-agentweb
Project-URL: Documentation, https://dlrsp.github.io/django-agentweb/
Project-URL: Repository, https://github.com/DLRSP/django-agentweb
Project-URL: Issues, https://github.com/DLRSP/django-agentweb/issues
Project-URL: Changelog, https://github.com/DLRSP/django-agentweb/blob/main/CHANGELOG.rst
Project-URL: Funding, https://github.com/sponsors/DLRSP
Keywords: django,llms-txt,ai-agents,schema-org,json-ld,webmcp,mcp,agentic-commerce,agent-ready-web,structured-data
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.12
Classifier: Framework :: Django :: 5.2
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.2
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django>=3.2
Provides-Extra: webmcp
Requires-Dist: requests>=2.28; extra == "webmcp"
Provides-Extra: webbotauth
Requires-Dist: cryptography>=42; extra == "webbotauth"
Provides-Extra: commerce
Requires-Dist: requests>=2.28; extra == "commerce"
Provides-Extra: all
Requires-Dist: requests>=2.28; extra == "all"
Requires-Dist: cryptography>=42; extra == "all"
Provides-Extra: testing
Requires-Dist: coverage; extra == "testing"
Requires-Dist: codecov; extra == "testing"
Requires-Dist: pytest; extra == "testing"
Requires-Dist: pytest-django; extra == "testing"
Requires-Dist: playwright>=1.40; extra == "testing"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.5; extra == "docs"
Requires-Dist: mkdocs-material>=9.0; extra == "docs"
Requires-Dist: pymdown-extensions>=10.0; extra == "docs"
Requires-Dist: mkdocs-git-revision-date-plugin>=2.0; extra == "docs"
Provides-Extra: linting
Requires-Dist: flake8; extra == "linting"
Requires-Dist: flake8-pyproject; extra == "linting"
Requires-Dist: flake8-bugbear; extra == "linting"
Requires-Dist: flake8-comprehensions; extra == "linting"
Requires-Dist: flake8-tidy-imports; extra == "linting"
Requires-Dist: flake8-typing-imports; extra == "linting"
Requires-Dist: pylint; extra == "linting"
Dynamic: license-file

# django-agentweb

[![CI/CD](https://github.com/DLRSP/django-agentweb/actions/workflows/ci.yaml/badge.svg)](https://github.com/DLRSP/django-agentweb/actions/workflows/ci.yaml)
[![PyPI](https://img.shields.io/pypi/v/django-agentweb.svg)](https://pypi.org/project/django-agentweb/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-GitHub_Pages-blue)](https://dlrsp.github.io/django-agentweb/)

Make your Django site a **first-class citizen of the agentic web**.

`django-agentweb` helps AI agents discover, understand, and act on your site
across five complementary domains. Every domain is **opt-in** and **off by
default**.

> Status: **alpha**. Core domains are implemented and opt-in. Booking adapters
> and some extras follow — see the [docs](https://dlrsp.github.io/django-agentweb/).

## Domains

| Domain | What it provides |
|--------|------------------|
| **Readability** | `llms.txt` / `llms-full.txt` |
| **Structured data** | Schema.org JSON-LD profiles |
| **Discovery** | `/.well-known/` agent descriptors |
| **WebMCP** | In-page tools agents can call |
| **Commerce / SDF** | Booking discovery hooks; SDF (flag, off) |

## Install

```bash
pip install django-agentweb
pip install "django-agentweb[webmcp]"   # optional: server-side tool proxy
pip install "django-agentweb[all]"      # optional: all extras
```

Requires `django.contrib.sites`.

## Quickstart

```python
# settings.py
INSTALLED_APPS = [
    # ...
    "django.contrib.sites",
    "agentweb",
]

APP_CONFIG = {
    "agentweb": {
        "LLMS": {"ENABLED": True},  # content: admin LLMS documents (or settings fallback)
        "JSONLD": {"ENABLED": True},
        "DISCOVERY": {"ENABLED": True},
    },
}
```

```python
# urls.py
from django.urls import include, path

urlpatterns = [
    # ...
    path("", include("agentweb.urls")),
]
```

Enabling a domain alone is not always enough: some features need middleware,
template tags, or a management command. See the
[Getting started](https://dlrsp.github.io/django-agentweb/getting-started/)
and [Configuration](https://dlrsp.github.io/django-agentweb/configuration/)
guides.

## License

MIT — see [`LICENSE`](LICENSE).
