Build full-stack apps with PyGo

Why PyGo?

Go Native Networking

Uses Go’s native net/http and database/sql — no heavy frameworks like Gin or SQLAlchemy bloat.

Python stdlib

Leverages Python’s standard library. Zero heavy frameworks. Ultra-light and fast.

Isomorphic DSL

Write .pgo files once. Generates 1:1 Python (gen_py.py) and mechanical Go code (gen_go.go).

Messagepack + UDS

Go and Python interoperate via MessagePack over Unix Domain Sockets (UDS).

HTMX First

Server-driven UI with HTMX. No client-side JavaScript framework bloat.

DevX Focused

Simple, fast, secure — designed for developer happiness and minimal setup.

Features (v1.0.0)

• Enum Types: Native enum support with compile-time validation
• ForeignKey & JOINs: Automatic JOIN generation and relationship handling
• Array[T] / Map[K]V: Generic collection types with full type safety
• Optional: Explicit nullability with String? syntax
• Scalars: UUID, Email, DateTime, URL, Phone, Decimal — validated at compile time
• Transpiler: AST visitor that mechanically generates Go and Python code

What’s Included (v1.0.0)

Component	Status
Enum Types	✅ Complete
ForeignKey & JOINs	✅ Complete
Array[T] / Map[K]V	✅ Complete
Optional (Type?)	✅ Complete
UUID, Email, DateTime	✅ Complete
AST Visitor Transpiler	✅ Complete
Code Generation (gen_py.py + gen_go.go)	✅ Complete
MessagePack + UDS Interop	✅ Complete
Hot Reload	✅ Complete
Multi-tenancy	✅ Complete
Background Jobs	✅ Complete

Frozen Until Stable

The following are frozen (not started) until v1.0.0:

• PyGo Cloud, Mobile, Desktop, Marketplace, MCP, IDE extensions
• Native WebSockets, File Upload, Asset Pipeline, Advanced i18n

Next Steps

Getting Started

Learn how to install PyGo and build your first app in minutes.

Tutorials (DX)

Step-by-step tutorials for every native package.

CLI Reference

Full CLI documentation including pygo module commands.

Runtime API

Native packages: storage, cache, queue, logger, auth, and more.

pygo-mcp

Model Context Protocol server for AI assistant integration.