Documentation

Get started with PlanLlama and build reliable programming patterns in minutes

Quick Start

1. Install

npm install planllama

2. Get API Token

Sign up and get your project API token from the dashboard

3. Start Building

Publish jobs, register workers, and orchestrate workflows

Core Concepts

Publishing Jobs

Send jobs to the queue with data and options. Jobs can be fire-and-forget or request-response.

const jobId = await client.publish(
  'send-email',
  { to: 'user@example.com' }
);

Processing Jobs

Register worker functions that process jobs. Workers run concurrently and handle retries automatically.

client.work('send-email', async (job) => {
  await sendEmail(job.data);
  return { sent: true };
});

Request-Response

Wait for job completion and get results synchronously. Perfect for API integrations.

const result = await client.request(
  'calculate',
  { x: 5, y: 10 }
);

Workflows

Define multi-step workflows with dependencies. Steps execute in order based on dependencies.

await client.workflow('order', {
  'step1': async () => { 
    return { valid: true }; 
  },
  'step2': ['step1', async (results) => { 
    return { processed: true }; 
  }]
});

Language Support

JavaScript/TypeScript

Full-featured library with TypeScript support and async/await interface.

npm install planllama

Python

Async/await interface with comprehensive features and Pythonic patterns.

pip install planllama

Ruby

Production-ready with idiomatic Ruby patterns and thread-safe operations.

gem install planllama

Go

Type-safe implementation with context support and idiomatic Go patterns.

go get github.com/BaudehloBiz/planllama-go

Resources

API Reference

Complete API documentation with all methods, options, and examples.

View API Reference →

GitHub Repositories

Explore our open-source client libraries and example projects.

View on GitHub →

Code Examples

Real-world examples and best practices for common use cases.

See Examples →

Migration Guides

Switch from other job queue systems with step-by-step migration guides.

View Migration Guides →