01 — Install

One command, zero config

MeowGPT runs on Bun. No install needed — just bunx meowgpt. Or add it to your project. No API keys, no database, no external services.

terminal

$ bunx meowgpt

    /\_/\
   ( o.o )   🐱  MeowGPT
    > ^ <     OpenAI-compatible mock server

  Local:              http://localhost:8787/v1
  Hosted:             https://meowgpt.alfian.dev/v1

  Endpoints:
    GET  /v1/models
    POST /v1/chat/completions
    POST /v1/images/generations

  Use in your AI agent / OpenAI client:
    baseURL: "http://localhost:8787/v1"
    apiKey:  "meow" (any value works)

Or add to your project

Install as a dev dependency for CI pipelines and local testing.

terminal

$ bun add -d meowgpt
$ bun meowgpt

CLI options

Customize host and port, or check the version. No subcommands — just run it.

terminal

$ meowgpt --host 0.0.0.0 --port 8080
$ meowgpt -v
0.1.3
$ meowgpt -h
🐱 MeowGPT — OpenAI-compatible mock server

Usage:
  meowgpt [options]
  meowgpt -h, --help
  meowgpt -v, --version

Options:
  --host      Host to bind (default: localhost)
  --port      Port to bind (default: 8787)
  -h, --help  Show this help
  -v, --version  Show version

No install? Use the hosted version

Point your OpenAI client at https://meowgpt.alfian.dev/v1. Always available, zero setup.

terminal

$ curl https://meowgpt.alfian.dev/v1/models

Cloudflare Workers

Deploy your own instance to Cloudflare with a single command.

terminal

$ bun run deploy
# or
$ wrangler deploy

← Home Usage →