---
id: schematics
version: "2.1.1"
license: BSD
license_treatment: permissive
maintenance: abandoned
---

# schematics — Python Data Structures for Humans

License: permissive · Maintenance: abandoned · Downloads: 638.4K/mo

## What it is and what it does

Schematics is a Python library for building and validating structured data using type definitions. It lets you declare data models with typed fields (like StringType, URLType, etc.), then validate incoming data against those schemas and convert between formats like JSON. The library is modeled after ORM type systems but has no database layer—it stops at data validation and transformation, leaving persistence to you.

Common uses include documenting API input schemas, validating request payloads, serializing objects to JSON or other formats, and filtering fields based on access control. You define a Model class with typed fields, instantiate it with data, call validate() to check constraints, and use to_primitive() to export as a dictionary or JSON.

Use it for:

- Validate API request bodies against a schema before processing them
- Convert between JSON and Python objects with type checking and field filtering
- Define and document message formats for RPC or other communication protocols
- Enforce required fields and data types in configuration or input files
- Serialize domain objects to JSON while hiding fields based on user permissions

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Schematics defines, validates, and transforms Python data structures using type-based schemas, with no database layer—useful for API validation, data serialization, and format conversion.

No—the project is abandoned (last release 2021-08-17, no commits since 2023-07-12). While it has low install friction and a permissive license, the lack of maintenance means no bug fixes, security patches, or compatibility updates for modern Python versions. For new projects, use actively maintained alternatives.

## Install

pip install schematics
uv add schematics
poetry add schematics

## Installing schematics

Before you install: Low install friction with no runtime dependencies. However, the project is abandoned—last release was 2021-08-17, with the last commit on 2023-07-12. Maintenance has stopped.

License in practice: BSD license (permissive) means you can use, modify, and distribute the package freely with minimal restrictions, provided you include the license notice.

Quickstart:

from schematics.models import Model
from schematics.types import StringType, URLType

class Person(Model):
    name = StringType(required=True)
    website = URLType()

person = Person({'name': 'Joe', 'website': 'http://example.com'})
person.validate()  # raises DataError if invalid
print(person.to_primitive())

Verify before relying:

- Whether the package works reliably with Python versions beyond 3.9, given the last release predates newer Python versions
- Whether there are known compatibility issues with modern dependency ecosystems or serialization libraries

## Package facts

- License: BSD (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 638.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

python data validation schema, type-based data structures, api input validation, data serialization and transformation, json schema validation, structured data models, format conversion library, data-validation, schema-definition, abandoned

[View on SkillFed](https://skillfed.io/packages/schematics) · [View on PyPI](https://pypi.org/project/schematics/)