Skip to content

This is the multi-page printable view of this section. .

Return to the regular view of this page.

Overview

What is Piglet Run?

Piglet Run is a lightweight runtime environment from Pigsty, designed as a cloud coding sandbox for AI Web Coding. It integrates PostgreSQL database, JuiceFS distributed storage, VS Code, JupyterLab, and more into a unified environment.

Why Piglet Run?

In the age of AI-assisted development, developers need:

  • Instant development environments that just work
  • Powerful databases with all extensions available
  • Safe experimentation with easy rollback
  • Seamless collaboration between humans and AI agents

Piglet Run provides all of this in a single package.

Key Features

Feature Description
🤖 AI Coding Pre-installed Claude Code, OpenCode, VS Code, Jupyter
🐘 Data Powerhouse PostgreSQL 18 + 400+ extensions
💾 Shared Storage JuiceFS stores workspace in database
⏱ī¸ Time Machine Database PITR + filesystem snapshots
🔀 Instant Clone Copy-on-Write database forking
🌐 One-Click Deploy Built-in Nginx with auto SSL
📊 Full Observability VictoriaMetrics + Grafana
🇨đŸ‡ŗ China Friendly Global CDN + China mirrors

Who is it for?

  • Solo developers who want a powerful dev environment
  • Teams that need shared development infrastructure
  • AI developers using Claude Code or similar tools
  • Data scientists working with PostgreSQL and Jupyter
  • Learners exploring PostgreSQL and web development

How it works 

┌─────────────────────────────────────────────────────────────┐
│                      Piglet Run                             │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐       │
│  │ VS Code │  │ Jupyter │  │ Claude  │  │  Nginx  │       │
│  │ Server  │  │   Lab   │  │  Code   │  │ Proxy   │       │
│  └────â”Ŧ────┘  └────â”Ŧ────┘  └────â”Ŧ────┘  └────â”Ŧ────┘       │
│       │            │            │            │             │
│       └────────────┴────────────┴────────────┘             │
│                         │                                   │
│  ┌──────────────────────┴──────────────────────┐           │
│  │              JuiceFS (Shared Storage)       │           │
│  └──────────────────────â”Ŧ──────────────────────┘           │
│                         │                                   │
│  ┌──────────────────────┴──────────────────────┐           │
│  │         PostgreSQL 18 + 400+ Extensions     │           │
│  └─────────────────────────────────────────────┘           │
│                                                             │
│  ┌─────────────────────────────────────────────┐           │
│  │      VictoriaMetrics + Grafana (Monitoring) │           │
│  └─────────────────────────────────────────────┘           │
└─────────────────────────────────────────────────────────────┘

Next Steps