Get Started

Your first PitFast service.

Follow this hands-on guide to create, compile, and execute a portable WASI Component on the PitFast execution grid.

Step 01

Install the PitFast CLI

Install the standalone developer CLI on Linux or macOS via curl:

bash
curl -fsSL https://get.pitfast.dev | sh
pit --version
Step 02

Initialize a new service

Create a new project directory and scaffold a Go or Rust service template:

bash
mkdir my-service && cd my-service
pit init --language go
Step 03

Compile to a WASI Component

PitCrew compiles your source into a content-addressed Component with a deterministic SHA-256 fingerprint:

bash
pit build
Step 04

Start the local PitFast daemon

In a separate terminal, start the local execution grid with 8 shared execution lanes:

bash
pit garage start --lanes 8
Step 05

Push artifact and deploy logical service

Register your component with Paddock and map it to a logical ServiceId:

bash
pit push my-service:v1
pit deploy my-service my-service:v1
Step 06

Invoke via logical URI

Call your service directly through PitLane without opening a dedicated TCP port:

bash
pit call pit://my-service/hello
# Output: {"status":"ok","message":"Hello from PitFast WASI Component!"}

Next Step: Deep-dive into PitCrew compilation

Learn how PitCrew guarantees deterministic builds and manifests across different toolchains.

Build Your First Service