glimmer-cli

Local CLI for Meta's Glimmer + Muse Spark 1.2 — with a reproducible tool-use eval harness.

Status (2026-08-16 20:30 UTC): Muse Glimmer 30B shipped Aug 10 — live on Ollama muse-glimmer 18GB Q4_K_M (27.9B, 131K, tools/vision/thinking) via ollama pull muse-glimmer (see docs/research/glimmer-availability-2026-08-16.md). Repo defaults to GLIMMER_MODEL=muse-glimmer with llama3.1:8b fallback. Native CLI: glimmer (after pnpm link --global or ln -sf $PWD/bin/glimmer ~/.local/bin/glimmer).

Quick start

git clone https://github.com/schererstefan/glimmer-cli.git
cd glimmer-cli
pnpm install

# Native CLI (no pnpm prefix needed after link)
ln -sf $PWD/bin/glimmer ~/.local/bin/glimmer  # or: pnpm link --global (adds $PNPM_HOME/bin to PATH via pnpm setup)
glimmer --help
glimmer --provider mock "What's the weather in Seattle tomorrow?"
glimmer --provider mock            # interactive REPL, --verbose for tool traces

# pnpm wrappers still work
pnpm cli --provider mock "What's the weather in Seattle tomorrow?"
pnpm test                           # vitest — all mocked, no network
pnpm eval --mock                    # runs 45 cases against mock, writes evals/COMPARISON.md

With a local model (Ollama) — Muse Glimmer 30B

# Install Ollama if needed
brew install ollama
brew services start ollama  # or: ollama serve &

ollama pull muse-glimmer            # 18GB Q4_K_M 27.9B — primary
glimmer --provider glimmer "What's the weather in Seattle tomorrow?"
glimmer --provider glimmer --model muse-glimmer --verbose "Book a meeting..."

# also available
ollama pull llama3.1:8b             # 4.9GB fallback
glimmer --provider glimmer --model llama3.1:8b "Hello"
pnpm glimmer:setup                  # pulls $GLIMMER_MODEL (default muse-glimmer) or fallback
pnpm glimmer:setup --dry-run

Hardware: muse-glimmer Q4_K_M ≈ 18 GB RAM/disk, 8B Q4_K_M ≈ 5 GB; 70B Q4 ≈ 40 GB (not for base Mac). Glimmer shows 15%/85% CPU/GPU via ollama ps.

With Muse Spark 1.2

cp .env.example .env.local  # add MUSE_SPARK_API_KEY and MUSE_SPARK_BASE_