Documentation

Build on real silicon, on your terms.

Reference, guides, and recipes for the mychipserver CLI, REST API, and CI integrations.

5 min

Quickstart

Reserve a board, flash a binary, and read its UART in five minutes.

Reference

CLI reference

Every command, flag, and exit code for the mychipserver CLI.

Reference

REST API

HTTP endpoints for sessions, devices, firmware, and telemetry.

Guides

Hardware CI recipes

Drop-in workflows for GitHub Actions, GitLab CI, and CircleCI.

Guide

Auth & API keys

Service tokens, scopes, rotation, and audit log access.

Per board

Per-board guides

Flash workflows, pinouts, and quirks for every supported chip.

Quickstart

Your first flash, in three commands.

Install the CLI, log in, and put bytes on a real board.

1Install the CLI

curl -fsSL https://get.mychipserver.com | sh

2Authenticate

mychipserver login

3Reserve & flash an ESP32-S3

mychipserver reserve --board esp32-s3
mychipserver flash ./build/app.bin

Example

Flash a board from your CI pipeline.

A complete GitHub Actions workflow that builds firmware, reserves a real ESP32-S3, flashes it, and runs smoke tests.

.github/workflows/firmware-ci.yml

name: Firmware CI
on: [push]
jobs:
  hil-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: pio run
      - uses: mychipserver/flash-action@v1
        with:
          board: esp32-s3
          firmware: .pio/build/esp32s3/firmware.bin
          token: ${{ secrets.MYCHIPSERVER_TOKEN }}
      - run: mychipserver test ./tests/smoke.yaml

New to mychipserver? Start with the tutorial.

A 15-minute walk-through that takes you from zero to a blinking LED on a real board in the cloud.

Start the tutorial Browse boards