Open Source

microcodegen.py

Turn a Product Requirements Document into a bootable FastAPI application — auth, CRUD, Pydantic schemas, Alembic migrations, /docs. One Python file. Zero dependencies. No API keys.

View on GitHub Full platform — free plan

Quickstart

# clone & run in 30 seconds

git clone https://github.com/Anioko/microcodegen

cd microcodegen

python microcodegen.py examples/task_manager.md --out ./my-app

# → my-app/ is a bootable FastAPI project

cd my-app

pip install -r requirements.txt

alembic upgrade head

uvicorn main:app --reload

# → http://localhost:8000/docs

The four stages

Inspired by Karpathy's micrograd: if the core algorithm doesn't fit in one file, you're hiding behind layers.

01parse_prd()

Pure regex extraction — finds entities, fields, user stories, integrations. No LLM calls.

02manifest_to_genome()

Converts the manifest into a stack-neutral architectural genome — the intermediate representation with ArchiMate 3.2 element typing.

03render_genome()

string.Template substitution over embedded FastAPI templates. Outputs SQLAlchemy 2.0 models, APIRouters, Pydantic schemas, Alembic migrations, tests.

04pack()

stdlib zipfile.ZipFile. Download the ZIP, push to GitHub, deploy.

What it generates

FastAPI app with /docs interactive explorer (Swagger UI)
SQLAlchemy 2.0 models (one per entity)
Pydantic v2 schemas — Base / Create / Update / Response
JWT auth — register / login / me (httpOnly cookies)
CRUD API routes for every entity
Per-tenant data isolation (user_id FK on every table)
Alembic migrations (alembic.ini + env.py)
pytest test suite with TestClient
ARCHITECTURE.md — ArchiMate 3.2 element map
openapi.yaml — full API contract (import into Postman)
docker-compose.yml + Dockerfile
requirements.txt

Write your PRD

# Task Manager

## Entities

- Project: name (string, required),

status (string)

- Task: title (string, required),

completed (boolean)

## User Stories

- As a developer, I want to manage

projects so that I can track work.

Save as prd.md → run python microcodegen.py prd.md

Need production output?

microcodegen.py generates FastAPI only. The full Archiet platform adds everything you need to ship to a real customer.

LLM-powered PRD extraction

Natural language, not just structured markdown

9 backend stacks

NestJS · Django · FastAPI · Go · Java · .NET · Laravel · Rails (+ Flask)

React / Next.js frontend

shadcn/ui, auth pages, settings, onboarding

Expo mobile app

iOS + Android, onboarding, settings, push notifications

13-gate shippability audit

Security scan, import coherence, boot test, AC coverage

Compliance packs

SOC 2, HIPAA, GDPR, PCI-DSS control matrices in every ZIP

GitHub push + drift detection

Push directly to your repo, detect architecture drift

Start free — no credit card See pricing

Loading…

Quickstart

# clone & run in 30 seconds

git clone https://github.com/Anioko/microcodegen

cd microcodegen

python microcodegen.py examples/task_manager.md --out ./my-app

# → my-app/ is a bootable FastAPI project

cd my-app

pip install -r requirements.txt

alembic upgrade head

uvicorn main:app --reload

# → http://localhost:8000/docs

The four stages

Inspired by Karpathy's micrograd: if the core algorithm doesn't fit in one file, you're hiding behind layers.

01parse_prd()

Pure regex extraction — finds entities, fields, user stories, integrations. No LLM calls.

02manifest_to_genome()

Converts the manifest into a stack-neutral architectural genome — the intermediate representation with ArchiMate 3.2 element typing.

03render_genome()

string.Template substitution over embedded FastAPI templates. Outputs SQLAlchemy 2.0 models, APIRouters, Pydantic schemas, Alembic migrations, tests.

04pack()

stdlib zipfile.ZipFile. Download the ZIP, push to GitHub, deploy.

What it generates

FastAPI app with /docs interactive explorer (Swagger UI)

SQLAlchemy 2.0 models (one per entity)

Pydantic v2 schemas — Base / Create / Update / Response

JWT auth — register / login / me (httpOnly cookies)

CRUD API routes for every entity

Per-tenant data isolation (user_id FK on every table)

Alembic migrations (alembic.ini + env.py)

pytest test suite with TestClient

ARCHITECTURE.md — ArchiMate 3.2 element map

openapi.yaml — full API contract (import into Postman)

docker-compose.yml + Dockerfile

requirements.txt

Need production output?

microcodegen.py generates FastAPI only. The full Archiet platform adds everything you need to ship to a real customer.

LLM-powered PRD extraction

Natural language, not just structured markdown

9 backend stacks

NestJS · Django · FastAPI · Go · Java · .NET · Laravel · Rails (+ Flask)

React / Next.js frontend

shadcn/ui, auth pages, settings, onboarding

Expo mobile app

iOS + Android, onboarding, settings, push notifications

13-gate shippability audit

Security scan, import coherence, boot test, AC coverage

Compliance packs

SOC 2, HIPAA, GDPR, PCI-DSS control matrices in every ZIP

GitHub push + drift detection

Push directly to your repo, detect architecture drift