Quickstart

npm install @nimblebrain/sdk

import { NimbleBrain } from '@nimblebrain/sdk';

const nb = new NimbleBrain({
  apiKey: process.env.NIMBLEBRAIN_API_KEY || 'nb_live_xxxxx',
});

const nb = new NimbleBrain({
  apiKey: 'nb_live_xxxxx',           // Required
  baseUrl: 'https://studio-api.nimblebrain.ai', // Optional (this is the default)
});

const agents = await nb.agents.list();

console.log('Your agents:');
for (const agent of agents) {
  console.log(`- ${agent.name} (${agent.id})`);
}

const playbooks = await nb.playbooks.list();

console.log('Your playbooks:');
for (const playbook of playbooks) {
  console.log(`- ${playbook.name} (${playbook.id})`);
}

// Get the first agent
const agents = await nb.agents.list();
const agent = agents[0];

// Create a new conversation
const conversation = await nb.conversations.create(agent.id, 'My First Chat');
console.log(`Created conversation: ${conversation.id}`);

// Send a message and stream the response
console.log('\nAgent response:');
for await (const event of nb.messages.stream(agent.id, conversation.id, 'Hello! What can you help me with?')) {
  if (event.type === 'content') {
    process.stdout.write(event.data.text as string);
  }
}
console.log('\n');

// Get the first playbook
const playbooks = await nb.playbooks.list();
const playbook = playbooks[0];

// Execute the playbook
console.log(`Executing playbook: ${playbook.name}`);
const { id: executionId } = await nb.playbooks.execute(playbook.id);

// Wait for completion
const execution = await nb.executions.waitForCompletion(executionId, {
  timeoutMs: 120000,  // 2 minutes
  pollIntervalMs: 2000, // Check every 2 seconds
});

console.log(`Status: ${execution.status}`);
console.log(`Result: ${execution.result}`);

import { NimbleBrain } from '@nimblebrain/sdk';

async function main() {
  // Initialize
  const nb = new NimbleBrain({
    apiKey: process.env.NIMBLEBRAIN_API_KEY!,
  });

  try {
    // List available agents
    const agents = await nb.agents.list();
    console.log(`Found ${agents.length} agents`);

    if (agents.length === 0) {
      console.log('No agents found. Create one in NimbleBrain Studio first.');
      return;
    }

    // Chat with the first agent
    const agent = agents[0];
    console.log(`\nChatting with: ${agent.name}`);

    const conversation = await nb.conversations.create(agent.id);

    // Stream the response
    process.stdout.write('\nAgent: ');
    for await (const event of nb.messages.stream(
      agent.id,
      conversation.id,
      'Hello! Give me a brief introduction of yourself.'
    )) {
      if (event.type === 'content') {
        process.stdout.write(event.data.text as string);
      }
    }
    console.log('\n');

  } catch (error) {
    console.error('Error:', error);
  }
}

main();

try {
  const agents = await nb.agents.list();
} catch (error) {
  if (error instanceof Error) {
    console.error('API error:', error.message);
  }
}