django-pydantic-field

What it is and what it does

django-pydantic-field bridges Pydantic and Django by allowing you to use Pydantic models as schemas for Django's JSONField. Instead of storing raw JSON and manually validating it, you define a Pydantic model and attach it to a SchemaField—the package then automatically parses incoming JSON into typed Pydantic instances and validates them against your schema. It handles both Pydantic v1 and v2 through a unified API, so you don't need to rewrite code if you upgrade.

The package integrates deeply with Django's ecosystem: it works with Django Forms and the Admin interface for validation and editing, provides typed serializers and parsers for Django REST Framework with automatic OpenAPI schema generation, and supports forward references for schemas defined later in your code. Type checkers like mypy and pyright can infer the correct types for your model fields, making it safe to use in statically typed codebases.

Use it for

• Store complex nested configuration objects in a Django model with automatic Pydantic validation and type safety.
• Build Django REST Framework APIs where request/response bodies are strongly typed Pydantic models with auto-generated OpenAPI docs.
• Migrate from raw JSON storage to typed schemas without rewriting your entire data layer.
• Use Django Admin to edit JSON data with form validation powered by Pydantic field constraints.
• Define forward-referenced schemas that resolve lazily, allowing circular dependencies between models.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

django-pydantic-field on PyPI

Before you install

Low friction install with three straightforward runtime dependencies. Actively maintained with a recent commit on 2026-02-22 and no known vulnerabilities.

Requires Python 3.10 or later.

License in practice

MIT license permits unrestricted use, modification, and distribution in commercial and private projects with minimal restrictions.

Quickstart

pip install django-pydantic-field

from django.db import models
from django_pydantic_field import SchemaField
import pydantic

class Foo(pydantic.BaseModel):
    count: int
    slug: str = "default"

class MyModel(models.Model):
    foo: Foo = SchemaField()

model = MyModel(foo={"count": 42})
model.save()
assert isinstance(model.foo, Foo)

Package facts

Evidence: django_pydantic_field-0.5.4-py3-none-any.whl

Tags

More Application Frameworks packages

See also jsonschema-pydantic · pydantic-extra-types · pydantic-partial · safety-schemas · drf-pydantic · pydantic-function-models · sigstore-models · pydantic_yaml · json-schema-to-pydantic · pydantic-compat