---
id: hologram
version: "0.0.16"
license: MIT
license_treatment: permissive
maintenance: aging
---

# hologram — JSON schema generation from dataclasses

License: permissive · Maintenance: aging · Downloads: 1.7M/mo

## What it is and what it does

Hologram is a lightweight library that automatically generates JSON Schemas (Draft 7 compatible) from Python dataclasses. It eliminates the need to write schemas by hand by inspecting your dataclass definitions and producing valid JSON Schema output. The library depends on python-dateutil, jsonschema, and dataclasses (the latter being built-in for Python 3.7+).

The package is designed for developers who want to keep their data models and their schemas in sync without duplication. It's a fork of dataclasses-jsonschema and targets Python 3.6 through 3.9 according to its classifiers. With no known security vulnerabilities and a permissive MIT license, it's straightforward to integrate into existing projects, though the aging maintenance status means it may not receive updates for newer Python versions or JSON Schema specifications.

Use it for:

- Generate API request/response schemas automatically from dataclass definitions for FastAPI or Flask endpoints
- Create JSON Schema validation rules from dataclasses to validate incoming data without writing schemas separately
- Document data structures by exporting dataclass-derived schemas for API documentation or OpenAPI specs
- Ensure consistency between Python type definitions and their JSON representations in microservices

## Worth the install?

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

Generates Draft 7 compatible JSON Schemas directly from Python 3.6+ dataclasses without manual schema writing.

Yes, if you are working with Python 3.6–3.9 and need automatic JSON Schema generation from dataclasses. The low install friction, permissive license, and zero known vulnerabilities make it safe to use. However, be cautious if you require support for Python 3.10+ or expect ongoing maintenance—the project has not been updated since March 2023 and is no longer actively developed.

## Install

pip install hologram
uv add hologram
poetry add hologram

## Installing hologram

Before you install: Low install friction with three common dependencies. Last release was in March 2023 with no commits since November 2025, indicating the project is aging but stable and not actively maintained.

License in practice: MIT license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install hologram

from dataclasses import dataclass
from hologram import JsonSchemaMixin

@dataclass
class Example(JsonSchemaMixin):
    name: str
    age: int

schema = Example.json_schema()

Verify before relying:

- Whether the package still works reliably with Python 3.10+ given the last release predates those versions
- Whether Draft 7 schema output remains compatible with current JSON Schema validators and tooling

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 1.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

json schema from dataclasses, dataclass to json schema, python schema generation, draft 7 schema generator, automatic json schema, schema-generation, dataclass-tooling

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