Documentation

Install the CLI globally. The npm wrapper installs the native runtime into your local Gunmetal home.

npm i -g @dhruv2mars/gunmetal

• Public entrypoint for the CLI.
• Use `gunmetal setup` after install.

Run the guided setup. It connects one provider, checks auth, syncs models, creates one local key, and prints the first test command.

gunmetal setup

• Browser-session providers open auth.
• API-key providers store upstream keys locally.

Start opens the browser operator surface and keeps the OpenAI-compatible API available. Add --no-open when you only want the daemon.

gunmetal start
# Dashboard: http://127.0.0.1:4684/
# API: http://127.0.0.1:4684/v1

• Dashboard and API share the same daemon.
• Request history stays local.

Any client that accepts a custom OpenAI-compatible base URL, API key, and arbitrary model id can talk to Gunmetal.

OPENAI_BASE_URL=http://127.0.0.1:4684/v1
OPENAI_API_KEY=gm_your_local_key
MODEL=provider/model

• Use a Gunmetal key, not an upstream provider key.
• Models use provider prefixes.