Getting Started
Install the Melange CLI, authenticate, and explore the public model library.
The Melange CLI (melange) brings model discovery, benchmarks, repository
management, model uploads, and deployment guides to your terminal. It uses the
same Melange platform as the dashboard and works well for both people and
automation.
Using an AI coding agent?
The one-line installer below installs the CLI and the skill together — restart your agent afterward. Or install the skill separately and continue with Build with AI:
npx skills add zetic-ai/melange-cli --skill melange-cli \
--agent universal claude-code --global --yesInstall
Install the prebuilt CLI on macOS or Linux. Go is not required.
brew install zetic-ai/tap/melange
melange versionInstall the prebuilt CLI on macOS, Linux, or Windows. Go is not required.
npm install -g @zetic-ai/melange-cli
melange versionOne line on macOS or Linux — installs the CLI and the agent skill:
curl -fsSL https://raw.githubusercontent.com/zetic-ai/melange-cli/main/script/install.sh | shRestart your coding agent afterward so it can discover the skill. Re-run the same line any time to update both.
The installer downloads the release binary for your platform, verifies its SHA-256 checksum, and installs the skill for universal agents and Claude Code. When cosign is on your PATH it also verifies the release-workflow signature; pass | sh -s -- --require-signature to make it mandatory.
Installer options — append after sh -s -- or set the environment variable:
| Flag | Environment variable | Effect |
|---|---|---|
--version vX.Y.Z | MELANGE_VERSION | Install a specific release instead of latest |
--install-dir DIR | MELANGE_INSTALL_DIR | Binary directory; defaults to /usr/local/bin, falling back to ~/.local/bin |
--cli-only | MELANGE_SKIP_SKILL=1 | Skip the agent skill |
--skill-only | MELANGE_SKIP_CLI=1 | Skip the CLI |
--agent "A B" | MELANGE_SKILL_AGENTS | Agents to install for; defaults to universal claude-code |
--require-signature | MELANGE_REQUIRE_SIGNATURE=1 | Fail unless the release signature is verified |
curl -fsSL https://raw.githubusercontent.com/zetic-ai/melange-cli/main/script/install.sh \
| sh -s -- --version v1.2.3 --agent "universal claude-code codex"The skill is installed with npx skills when a recent Node is available, and copied directly into the agent skill directories otherwise.
With a current Go toolchain:
go install github.com/zetic-ai/melange-cli/cmd/melange@latest
melange versionMake sure your Go binary directory is on PATH.
Download the archive for your operating system and architecture from GitHub Releases. Each release includes checksums, a Sigstore bundle, and SBOMs.
Place the melange binary on PATH, then verify the installation:
melange versionAuthenticate
Log in with browser OAuth (recommended). The CLI stores the credential in your operating system keyring and refreshes it automatically:
melange auth loginFor CI or a headless environment, create a personal access token in Melange Dashboard under Settings → Personal Access Tokens, then read it from standard input:
melange auth login --with-token < token.txtOr provide a credential through the environment:
export MELANGE_API_KEY="ztp_your_personal_access_token"Check status
melange auth statusExplore the public library
Start with a read-only search. This does not import, upload, or modify a model.
melange library list --search LFM2.5-350M --json
melange library view shinilheo/LFM2.5_350M --jsonUse --json or --jq when another program consumes the output. Run
melange library list --help to see the available filters.