pi-muse-spark

Pi extension for Meta Model API — adds Muse Spark 1.2, 1.2-contributor & 1.1 to pi coding agent via API key.

Fork note & credit: This is a maintained fork of seemethere/pi-meta-ai which provides the original implementation for most of the work. Original credit goes to seemethere/pi-meta-ai and its contributors. This fork fixes the false not authenticated warning on pi v0.84+ (where authStorage was removed) and keeps Muse Spark 1.2 models up to date. Upstream is currently unmaintained.

Meta Model API is OpenAI-compatible with Responses API at https://api.meta.ai/v1. This extension registers provider meta-ai using openai-responses for full agentic support: tool calling, parallel tools, streaming, reasoning effort, structured output, image input, prompt caching, 1M context.

Prerequisites

• Node.js >=18
• Pi coding agent >=0.84:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version # should be >=0.84

Install

As pi package (recommended):

pi install git:github.com/EclipseAditya/pi-muse-spark

# pin to a version:
pi install git:github.com/EclipseAditya/pi-muse-spark@v0.2.0

From source (dev):

git clone https://github.com/EclipseAditya/pi-muse-spark
cd pi-muse-spark
pi -e ./extensions/meta-model-api

Migrate from pi-meta-ai:

pi remove git:github.com/seemethere/pi-meta-ai
pi remove git:github.com/RooseveltAdvisors/pi-meta-ai
pi install git:github.com/EclipseAditya/pi-muse-spark

Quick start

1. Get API key: https://dev.meta.ai → API keys → Create. Key format LLM|...

2. Authenticate (pick one):

   Option A — Inside pi (recommended):

   /login → API key → Meta Model API → paste LLM|... key
   

   Option B — Env var (before launching pi):

   export MODEL_API_KEY="LLM|..."
   # Also supports META_API_KEY as fallback
   
   pi
   # or from source:
   MODEL_API_KEY="LLM|..." pi -e ./extensions/meta-model-api
   

   Env vars must be set before launching pi. If you set them after pi is running, run /reload or restart pi from the shell where var is exported.

3. Select model:

   /model → meta-ai/muse-spark-1.2-contributor