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.

Use the Web UI when you want the browser operator surface. Use start when you only need the OpenAI-compatible API.

gunmetal web
# http://127.0.0.1:4684/webui
# http://127.0.0.1:4684/v1

• Web UI 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.