Piumo
Sign in

Getting Started

Welcome to Piumo — the AI-powered DevOps platform built for engineering teams that ship at scale. This guide walks you through setting up your first project in under 30 minutes.

**Note:** Piumo is currently in private beta. Reach out to hello@piumo.dev to request early access.

Prerequisites#

Before you begin, make sure you have:

  • A GitHub, GitLab, or Bitbucket account
  • Node.js 18+ or any modern runtime
  • An active Piumo account (free tier available)

Installation#

Install the Piumo CLI globally via npm:

bash
npm install -g @piumo/cli

# Verify the install
piumo --version

Authenticate#

Log in with your Piumo credentials:

bash
piumo login

This opens your browser for OAuth. Once authorised, your API token is stored in ~/.piumo/credentials.

Your First Project#

Initialise Piumo in an existing repo:

bash
cd my-repo
piumo init

The CLI will detect your stack, scaffold a .piumo/config.yml, and connect to your Git remote automatically.

**Tip:** Run `piumo init --template nextjs` to use a pre-built Next.js pipeline template.

Next Steps#

  • Connect your CI/CD provider in the Integrations section
  • Set up deployment environments
  • Invite your team members
  • Enable DORA metrics tracking