specter

Lightweight mock API server. Define endpoints in YAML, run instantly.

• Hot reload — edit config.yml and changes apply immediately
• Response templates, faker, stateful mocking, rate limiting
• Single binary, no dependencies

Install

Docker

docker run -v $(pwd)/config.yml:/config.yml ghcr.io/saku0512/specter -c /config.yml

Homebrew (macOS / Linux)

brew tap Saku0512/specter https://github.com/Saku0512/specter
brew install specter

curl (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/Saku0512/specter/main/install.sh | bash

PowerShell (Windows)

irm https://raw.githubusercontent.com/Saku0512/specter/main/install.ps1 | iex

Quick start

specter init          # generate config.yml
specter -c config.yml # start the server

routes:
  - path: /users
    method: GET
    response:
      - id: 1
        name: Alice

Documentation

• Config reference — routes, matching, templates, faker, state, rate limiting, …
• CLI reference — flags, env vars, init / gen / validate / record
• Introspection API — /__specter/requests, /__specter/state

See config.example.yml for a full working example.

License

MIT