PIGLET.RUN

— Pigsty Lightweight Runtime, AI Coding Sandbox for Vibe Coding

PIGLET is a lightweight runtime environment based on Pigsty, designed for AI Web Coding cloud sandbox. It integrates PostgreSQL database, JuiceFS distributed storage, VS Code, JupyterLab and more into one, enabling zero-friction workflow from “prompting code” to “production deployment”.

Key Features

Quick Start

Prepare a node with SSH access, running a compatible Linux distro, execute with an admin user having passwordless ssh and sudo:

curl -fsSL https://repo.pigsty.io/get | bash; cd ~/pigsty
./configure -c vibe -g # Use vibe mode, generate random passwords!
./deploy.yml           # Deploy infrastructure and PostgreSQL
./juice.yml            # Deploy JuiceFS filesystem
./vibe.yml             # Deploy Claude, Code-Server, JupyterLab

After installation, access the sandbox homepage via IP: http://<ip>. Assuming your IP is 10.10.10.10:

Tip: If deploying on a public cloud server, check Security Best Practices, change passwords (configure -g), and enable firewall.

Vibe Coding

By default /fs is the shared directory stored in PostgreSQL, also the default home for VS Code and Jupyter. The home directory contains CLAUDE.md/AGENTS.md environment docs, recommend Vibe Coding in this directory.

You can ssh to the server then cd /fs, use x to start claude, use xx to start Claude in YOLO mode. You can also start claude directly via VS Code and Jupyter’s Claude plugins or terminal.

Claude here has logs and monitoring metrics integrated with Grafana dashboards, monitor Claude’s running status through Grafana.

Using Other Models

To use other models like GLM 4.7 (no VPN required in China), modify pigsty.yml config during installation, find claude_env section at the bottom, add environment variables as needed:

    # you can use other models here!
    claude_env:
      ANTHROPIC_BASE_URL: https://open.bigmodel.cn/api/anthropic
      ANTHROPIC_API_URL: https://open.bigmodel.cn/api/anthropic
      ANTHROPIC_AUTH_TOKEN: your_api_service_token # Put your KEY here!
      ANTHROPIC_MODEL: glm-4.7
      ANTHROPIC_SMALL_FAST_MODEL: glm-4.5-air

Then re-run ./vibe.yml.

Claude Code Observability

To integrate Claude Code from other environments into the monitoring system, configure environment variables to send OTEL events to VictoriaMetrics / VictoriaLogs OTEL endpoints. Claude Code can self-vibe to handle this configuration.

# Claude Code OTEL Configuration
export CLAUDE_CODE_ENABLE_TELEMETRY=1             # Enable monitoring
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_LOG_USER_PROMPTS=1                    # Set to 0 to hide prompts
export OTEL_RESOURCE_ATTRIBUTES="job=claude"      # Add your own labels
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://10.10.10.10:8428/opentelemetry/v1/metrics     # Metrics endpoint, VictoriaMetrics
export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT=http://10.10.10.10:9428/insert/opentelemetry/v1/logs    # Logs endpoint, VictoriaLogs
export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=cumulative