Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.
description: "Generate Pydantic models from concept definitions in your .mthds files — turn declarative types into Python code automatically."
Build Structures
Generate Pydantic models from your concept definitions.
!!! note "Alias of codegen types"
pipelex build structures is an alias of pipelex codegen types --target python-structures: it resolves your bundles into a normalized library crate and emits a single stamped structures.py module plus a codegen.lock. Use pipelex codegen check to verify the generated files are current without regenerating.
Usage
pipelex build structures <TARGET> [OPTIONS]
Arguments:
TARGET- Either a library directory containing.mthdsfiles, or a specific.mthdsfile (its directory is used as the closure)
Options:
-o,--output-dir- Output directory for the generated module (defaults tostructures/in target's directory)-L,--library-dir- Additional directory of.mthdsbundles to load (repeatable)
Examples
Generate structures from a library directory:
pipelex build structures ./my_pipelines/
Generate structures from a specific bundle file:
pipelex build structures ./my_pipeline/bundle.mthds
Generate structures to a specific output directory:
pipelex build structures ./my_pipelines/ -o ./generated/
What Gets Generated
One structures.py module for the whole closure, plus a codegen.lock:
- Pydantic model classes - One
StructuredContentsubclass per concept, with types, constraints, and descriptions - Bare-when-unique names - A concept
demo.Reportbecomesclass Report; only a code that collides across domains gets the domain-qualified spelling - Stamp + lock - Each file carries a self-describing codegen stamp (crate fingerprint, engine version, content hash) and is tracked in
codegen.lock, sopipelex codegen checkcan detect drift offline - Declared imprecision - A concept whose shape cannot be fully derived is surfaced with an explicit caveat, never a silent guess
Generated files are never meant to be edited: to customize a type, subclass it in a sibling module (the generated header shows how) — subclasses survive regeneration.
Why Use Generated Structures?
- Use as type hints - Get IDE autocompletion and type checking in your code
- Add custom logic - Subclass the generated classes in your own module
- Integrate in your app - Use the models directly in your application
- Trust the drift check -
pipelex codegen checktells you when the models no longer match the method
Example Output
For a concept defined in a .mthds file like:
[concept.CandidateProfile]
description = "A structured representation of a candidate's professional background."
[concept.CandidateProfile.structure]
skills = { type = "text", description = "Technical and soft skills", required = true }
years_of_experience = { type = "number", description = "Total years of experience" }
education = { type = "text", description = "Educational background", required = true }
work_history = { type = "text", description = "Summary of previous roles", required = true }
You get (inside the stamped structures.py):
class CandidateProfile(StructuredContent):
"""A structured representation of a candidate's professional background."""
skills: str = Field(..., description="Technical and soft skills")
years_of_experience: Optional[float] = Field(default=None, description="Total years of experience")
education: str = Field(..., description="Educational background")
work_history: str = Field(..., description="Summary of previous roles")
Related Documentation
- Codegen projections - The engine behind this command (
codegen types, stamps, lock, offline check) - Build Inputs - Generate example input JSON for a pipe
- Build Output - Generate example output JSON for a pipe
- Concepts - Understanding concept definitions