muse-stack

Configuración para usar Muse Spark 1.2 Contributor (Meta) desde Claude Code y
Hermes, a través de routatic/proxy y una
suscripción de OpenCode Go.

No es un fork de routatic: routatic se instala tal cual desde upstream. Aquí solo
está la configuración y los dos proxies auxiliares que hacen falta para que la
cadena encaje.

Qué necesitas

• Una suscripción de OpenCode Go con su clave (sk-…). La cuota va por cuenta:
  cada persona necesita la suya.
• routatic-proxy instalado desde upstream.
• Python 3 y curl.
• Opcional: headroom para compresión de contexto, y Hermes.

Instalación

git clone https://github.com/Solar2004/muse-stack.git
cd muse-stack
./install.sh

El script pide la clave, la valida contra OpenCode antes de tocar nada, hace copia
de seguridad de la config que ya tuvieras, y deja los servicios levantados.

La cadena

Claude Code ──> headroom :8788 ──> cc-model-mask :3460 ──> routatic :3456 ──> OpenCode Go ──> Meta
Hermes ─────────────────────────────────────────────────> routatic :3456
                                    cc-openai-bridge :3461 ──> routatic :3456

Puerto	Proceso	Para qué
:3456	routatic-proxy	Enruta por escenario. Solo habla Anthropic Messages (/v1/messages)
:3460	cc-model-mask	Traduce el nombre del modelo y aplica el suelo de max_tokens
:3461	cc-openai-bridge	Traduce OpenAI → Anthropic para herramientas que solo hablan OpenAI
:8788	headroom	Compresión de contexto (opcional)

Tres trampas que cuestan tiempo

1. Muse necesita presupuesto para pensar

Muse Spark es un modelo de razonamiento: gasta ~256 tokens razonando antes de
emitir la primera letra. Con un max_tokens pequeño devuelve una respuesta vacía,
y routatic interpreta ese vacío como error 400 → agota fallbacks → 502.

max_tokens=1    →  respuesta sin 'choices'
max_tokens=16   →  content=None, 16 tokens gastados razonando
max_tokens=512  →  "¡Hola! 👋"  (255 tokens usados)

Claude Code manda una petición de sondeo con max_tokens=1 antes de la real, así
que esto se manifiesta como API error · Retrying nada más escribir. Por eso
cc-model-mask.py sube a MIN_MAX_TOKENS (1024) cualquier presupuesto menor.

Cualqui