argdantic

What it is and what it does

argdantic is a thin wrapper around argparse that uses pydantic models to define and validate command-line arguments. Instead of manually wiring up argument parsing and validation, you decorate functions with type hints and pydantic models, and argdantic automatically generates a CLI with help text, type checking, and field validation. It supports nested pydantic models for complex argument structures and nested commands for building hierarchical CLIs.

The package integrates with pydantic's settings system to pull arguments from multiple sources—environment variables, .env files, JSON, YAML, and TOML—without additional boilerplate. It targets developers who want modern, type-safe CLIs without the verbosity of manual argparse setup, and works across Python 3.8 through 3.12.

Use it for

• Build a typed CLI tool where arguments are validated as pydantic models before your function runs
• Create nested command hierarchies (subcommands) with shared argument validation logic
• Load CLI arguments from environment variables or config files alongside command-line flags
• Enforce argument types and constraints at parse time, catching errors before your code runs

Worth the install?

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

Install

argdantic on PyPI

Before you install

Low friction install with only pydantic and pydantic-settings as runtime dependencies. Package is dormant (581 days since last release) but was actively maintained through early 2025.

License in practice

MIT license (permissive) means you can use, modify, and distribute this package freely in both open-source and commercial projects with minimal restrictions.

Quickstart

pip install argdantic

from argdantic import ArgParser

parser = ArgParser()

@parser.command()
def greet(name: str, count: int = 1):
    for _ in range(count):
        print(f"Hello {name}")

if __name__ == "__main__":
    parser()

Package facts

Evidence: argdantic-1.3.3-py2.py3-none-any.whl

Tags

More Software Development packages

See also pydantic-argparse · prime-pydantic-config · arguably · argh · simple-parsing · typed-argument-parser · face · decli · targ · logmuse