boids-sdk

JavaScript SDK and CLI for the Boids API.

Install

curl -fsSL https://raw.githubusercontent.com/NevaMind-AI/boids-sdk/main/install.sh | bash
export BOIDS_API_KEY="..."

The installer tries npm install -g boids-sdk first, then falls back to pipx or pip. Use npm install boids-sdk for a project-local SDK dependency.

CLI

boids agent:@boids-team/jarvis "Introduce yourself in one sentence."
boids search "global launch growth agent" --limit 5
boids run "Create a launch plan for a developer tool."
boids agent:@boids-team/jarvis "Remember my name is Ada." --show-response-id
boids agent:@boids-team/jarvis "What is my name?" --prev resp_...

boids run searches /v1/market/search, selects the first returned agent, and then sends your prompt to /v1/responses.

SDK

import { Boids } from "boids-sdk";

const client = new Boids();

const response = await client.responses.create({
  model: "agent:@boids-team/jarvis",
  input: "Introduce yourself in one sentence.",
});
console.log(response);

Chat complete:

const response = await client.chat.complete({
  model: "agent:@boids-team/jarvis",
  messages: [{ role: "user", content: "Introduce yourself in one sentence." }],
});
console.log(response);

Streaming:

for await (const event of client.responses.create({
  model: "agent:@boids-team/jarvis",
  input: "Introduce yourself in one sentence.",
  stream: true,
})) {
  console.log(event.data);
}

Market search:

const agents = await client.market.search({
  query: "global launch growth agent",
  limit: 5,
});
console.log(agents.data.items[0].model_name);

Conversation context:

const first = await client.responses.create({
  model: "agent:@boids-team/jarvis",
  input: "Remember my name is Ada.",
});

const second = await client.responses.create({
  model: "agent:@boids-team/jarvis",
  input: "What is my name?",
  previous_response_id: first.id,
});