rhachet-brains-fireworksai

rhachet brain.atom adapter for fireworks ai open-source models

install

npm install rhachet-brains-fireworksai

usage

import { genBrainAtom } from 'rhachet-brains-fireworksai';
import { z } from 'zod';

// create a brain atom for direct model inference
const brainAtom = genBrainAtom({ slug: 'fireworks/deepseek/v4-flash' });

// simple string output
const { output: explanation } = await brainAtom.ask({
  role: { briefs: [] },
  prompt: 'explain this code',
  schema: { output: z.string() },
});

// structured object output
const { output: { summary, issues } } = await brainAtom.ask({
  role: { briefs: [] },
  prompt: 'analyze this code',
  schema: { output: z.object({ summary: z.string(), issues: z.array(z.string()) }) },
});

available brains

atoms (via genBrainAtom)

stateless inference with tool use support. all models below are verified on fireworks ai serverless.

frontier tier

highest capability models for complex tasks.

| slug | model | context | swe-bench | input | output | | --- | --- | --- | --- | --- | --- | | fireworks/kimi/k2.6 | Kimi-K2.6 | 128K | 80.2% | $0.95/1M | $4.00/1M | | fireworks/minimax/2.7 | MiniMax-M2.7 | 128K | 80.5% | $0.30/1M | $1.20/1M | | fireworks/minimax/2.5 | MiniMax-M2.5 | 128K | 80.2% | $0.30/1M | $1.20/1M | | fireworks/deepseek/v4-pro | DeepSeek-V4-Pro | 1M | 79.4% | $1.74/1M | $3.48/1M | | fireworks/deepseek/v4-flash | DeepSeek-V4-Flash | 1M | 78.6% | $0.14/1M | $0.28/1M | | fireworks/glm/5.1 | GLM-5.1 | 128K | 77.8% | $1.40/1M | $4.40/1M | | fireworks/kimi/k2.5 | Kimi-K2.5 | 128K | 76.8% | $0.60/1M | $3.00/1M |

cheapfast tier

models optimized for high-volume inference at low cost.

| slug | model | context | swe-bench | input | output | | --- | --- | --- | --- | --- | --- | | fireworks/gpt-oss/20b | GPT-OSS-20B | 128K | — | $0.07/1M | $0.30/1M | | fireworks/deepseek/v4-flash | DeepSeek-V4-Flash | 1M | 78.6% | $0.14/1M | $0.28/1M | | fireworks/gpt-oss/120b | GPT-OSS-120B | 128K | — | $0.15/1M | $0.60/1M | | fireworks/minimax/2.5 | MiniMax-M2.5 | 128K | 80.2% | $0.30/1M | $1.20/1M | | fireworks/minimax/2.7 | MiniMax-M2.7 | 128K | 80.5% | $0.30/1M | $1.20/1M | | fireworks/qwen3.6/plus | Qwen-3.6-Plus | 131K | — | $0.50/1M | $3.00/1M |

swe-bench verified scores from llm-stats.com and fireworks ai model cards.

tool use support

all 10 models support tool use via the openai-compatible function call api. tested capabilities:

| capability | status | | --- | --- | | tool invocation | all models | | tool continuation | all models | | structured output | all models (without tools) |

credentials

two patterns for credential injection:

repo level — keyrack shorthand

auto-discover FIREWORKS_API_KEY from keyrack:

import { genBrainAtom, genContextBrainSupplier } from 'rhachet-brains-fireworksai';

const context = genContextBrainSupplier('fireworks', {
  creds: { keyrack: { owner: 'ehmpath', env: 'prod' } },
});

const brainAtom = genBrainAtom({ slug: 'fireworks/deepseek/v4-flash' });
const { output } = await brainAtom.ask({ ... }, context);

user level — explicit getter

per-request credentials from vault, kms, or multi-tenant source:

import { genBrainAtom, genContextBrainSupplier } from 'rhachet-brains-fireworksai';

const context = genContextBrainSupplier('fireworks', {
  creds: async () => ({
    FIREWORKS_API_KEY: await vault.get(`tenant/${tenantId}/fireworks`),
  }),
});

const brainAtom = genBrainAtom({ slug: 'fireworks/deepseek/v4-flash' });
const { output } = await brainAtom.ask({ ... }, context);

fallback — environment variable

if no context provided, falls back to FIREWORKS_API_KEY environment variable.

get your api key at https://api.fireworks.ai/inference/settings/api-keys

sources

• fireworks ai api docs
• fireworks ai models
• fireworks ai rates