djangorestframework-pydantic-ai
Expose djangorestframework-services
services and selectors as a Pydantic-AI toolset, so a
plain pydantic_ai.Agent can call them as tools — no MCP server and no AG-UI
bridge in the path.
Every tool call routes through drf-services' transport-neutral surface
(dispatch_spec plus its off-HTTP helpers), so a tool call runs the same input
validation, the same permission_classes — both class-level has_permission
and object-level has_object_permission on the resolved row — and the same
serializer rendering your DRF views apply, just without the HTTP hop.
Install
pip install djangorestframework-pydantic-ai
It depends only on djangorestframework-services and pydantic-ai-slim. A model
provider is pulled in separately, the usual Pydantic-AI way (e.g.
pip install "pydantic-ai-slim[anthropic]").
Quickstart
from pydantic_ai import Agent
from rest_framework_pydantic_ai import AgentDeps, SpecToolset
toolset = SpecToolset({
"list_orders": orders_selector_spec, # SelectorSpec -> read-only tool
"create_order": create_order_spec, # ServiceSpec -> mutation tool
})
agent = Agent("anthropic:claude-opus-4-8", deps_type=AgentDeps, toolsets=[toolset])
result = await agent.run(
"create an order of 3 widgets",
deps=AgentDeps(user=request.user),
)
The agent acts as deps.user: each call builds an off-HTTP request/view context,
enforces the spec's permission_classes (class- and object-level),
dispatches the spec, and renders the result through the spec's serializer. List
selectors gain page / limit / order tool args.
Failures map onto the model loop so the agent self-corrects: invalid input, a bad
page / limit / order value, and unexpected (hallucinated) arguments come
back as ModelRetry; a business error or missing row becomes a readable
{"error": ...}; a denied permission raises PermissionDenied and aborts the
run. Unexpected arguments are rejected by default — pass unknown_arguments=
to SpecToolset (IGNORE / PASSTHROUGH) to change that.
See the documentation for the full reference.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file djangorestframework_pydantic_ai-0.11.0.tar.gz.
File metadata
- Download URL: djangorestframework_pydantic_ai-0.11.0.tar.gz
- Upload date:
- Size: 137.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
180432dee20d7b744e5b6fb33e8fbed1b01b9b520fac4002e752269ef271ecfb
|
|
| MD5 |
3ad0919ae680a171145698521bbf059e
|
|
| BLAKE2b-256 |
6a05bc64d9ee080203dea87293343df0d9642bad528b41f91956470e8e95d544
|
Provenance
The following attestation bundles were made for djangorestframework_pydantic_ai-0.11.0.tar.gz:
Publisher:
release.yml on Artui/djangorestframework-pydantic-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
djangorestframework_pydantic_ai-0.11.0.tar.gz -
Subject digest:
180432dee20d7b744e5b6fb33e8fbed1b01b9b520fac4002e752269ef271ecfb - Sigstore transparency entry: 2303193633
- Sigstore integration time:
-
Permalink:
Artui/djangorestframework-pydantic-ai@6a78ef93b373591d6dd6de8a452b11005115bc23 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Artui
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6a78ef93b373591d6dd6de8a452b11005115bc23 -
Trigger Event:
push
-
Statement type:
File details
Details for the file djangorestframework_pydantic_ai-0.11.0-py3-none-any.whl.
File metadata
- Download URL: djangorestframework_pydantic_ai-0.11.0-py3-none-any.whl
- Upload date:
- Size: 21.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
87e65230ce4ef8d5c8f6ad34b83398d4b814f5f14ea33670911be9150897b2b8
|
|
| MD5 |
b973a10029dc08af67316274f6388d56
|
|
| BLAKE2b-256 |
023344079b8f90e0b71e8f1a8bf8e8e0f001d184f49aea103555675603f4a590
|
Provenance
The following attestation bundles were made for djangorestframework_pydantic_ai-0.11.0-py3-none-any.whl:
Publisher:
release.yml on Artui/djangorestframework-pydantic-ai
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
djangorestframework_pydantic_ai-0.11.0-py3-none-any.whl -
Subject digest:
87e65230ce4ef8d5c8f6ad34b83398d4b814f5f14ea33670911be9150897b2b8 - Sigstore transparency entry: 2303193639
- Sigstore integration time:
-
Permalink:
Artui/djangorestframework-pydantic-ai@6a78ef93b373591d6dd6de8a452b11005115bc23 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Artui
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@6a78ef93b373591d6dd6de8a452b11005115bc23 -
Trigger Event:
push
-
Statement type:
