Prism CLI for generating full-stack CRUD apps from Pydantic specs. Use when creating projects, generating code, running migrations, managing Docker, deploying, or working with Prism specifications.
Prism (prisme on PyPI) is a code generation framework that produces full-stack CRUD applications from Pydantic model specifications. Python 3.13+.
Always prefix commands with uv run (e.g., uv run prism generate).
uv run prism create my-app # 1. Create project
# Edit specs/models.py # 2. Define models
uv run prism generate # 3. Generate code
uv run prism install # 4. Install deps
uv run prism db init # 5. Init migrations
uv run prism db migrate # 6. Run migrations
uv run prism dev # 7. Start dev servers
prism create <name> — Create a new projectprism generate — Generate code from specs (--dry-run to preview)prism validate — Validate spec filesprism devprism install — Install dependenciesprism test — Run testsprism db init|migrate|reset|seed — Database operationsprism docker init|logs|shell|down|reset-db|backup-db|restore-db|init-prod|build-prod — Dockerprism review list|diff|show|mark-reviewed|clear|restore — Code override reviewprism deploy init|plan|apply|destroy|ssh|logs|status|ssl — Hetzner/Terraform deploymentprism ci init|status|validate|add-docker — CI/CD pipelinesprism devcontainer up|down|shell|logs|status|list|exec|test|migrate|url|generate — Dev containersprism proxy status|diagnose|restart — Reverse proxyprism auth login|logout|status — Authenticationprism subdomain list|claim|activate|status|release — Managed subdomainsprism projects list|down-all — Multi-project managementFor the full command reference with descriptions, see commands.md.
Projects are defined via a StackSpec in specs/models.py:
from prism.spec import StackSpec, ModelSpec, FieldSpec, FieldType
from prism.spec import RESTExposure, GraphQLExposure, FrontendExposure
stack = StackSpec(
name="my-app",
models=[
ModelSpec(
name="Customer",
fields=[
FieldSpec(name="name", type=FieldType.STRING, required=True),
FieldSpec(name="email", type=FieldType.STRING, required=True),
],
rest=RESTExposure(enabled=True),
graphql=GraphQLExposure(enabled=True),
frontend=FrontendExposure(enabled=True),
),
],
)
STRING, TEXT, INTEGER, FLOAT, DECIMAL, BOOLEAN, DATETIME, DATE, TIME, UUID, JSON, ENUM, FOREIGN_KEY
from prism.spec import RelationshipSpec
ModelSpec(
name="Order",
fields=[
FieldSpec(name="customer_id", type=FieldType.FOREIGN_KEY, references="Customer"),
],
relationships=[
RelationshipSpec(
name="customer",
target_model="Customer",
type="many_to_one",
back_populates="orders",
),
],
)
project/
├── prism.config.py # Configuration
├── specs/models.py # Model specifications
├── packages/
│ ├── backend/src/<pkg>/
│ │ ├── models/ # SQLAlchemy models
│ │ ├── schemas/ # Pydantic schemas (generated, do not edit)
│ │ ├── services/
│ │ │ ├── _generated/ # Generated base classes (do not edit)
│ │ │ └── *_service.py # User extension files (safe to edit)
│ │ ├── api/rest/ # REST endpoints
│ │ ├── api/graphql/ # GraphQL types
│ │ └── mcp_server/ # MCP tools
│ └── frontend/src/
│ ├── types/ # TypeScript types (generated, do not edit)
│ ├── components/
│ │ ├── _generated/ # Generated components (do not edit)
│ │ └── *.tsx # User extension files (safe to edit)
│ ├── hooks/
│ ├── pages/
│ └── graphql/
_generated/, schemas/, or types/ — they are regenerated_generated/prism generate then prism db migrate if schema changedprism generate --dry-run to preview changes before applying