KaibanJS

KaibanJS

The JavaScript Framework for Building Multi-agent Systems.

--- ## Kanban for AI Agents? **KaibanJS** is inspired by the tried-and-true [Kanban methodology](), which is well-known for helping teams organize and manage their work. We've adapted these concepts to meet the **unique challenges of AI agent management**. If you've used tools like Trello, Jira, or ClickUp, you'll be familiar with how Kanban helps manage tasks. Now, KaibanJS uses that same system to help you manage AI agents and their tasks in real time. **With KaibanJS, you can:** - Create, visualize, and manage AI agents, tasks, tools, and teams - Orchestrate AI workflows seamlessly - Visualize workflows in real-time - Track progress as tasks move through different stages - Collaborate more effectively on AI projects ## Try It Out [Explore the Kaiban Board](https://www.kaibanjs.com/playground) — _it's like Trello or Asana, but for AI Agents and humans._ ## Quick Start Get started with KaibanJS in under a minute: ## Setup **1. Run the KaibanJS initializer in your project directory:** ```bash npx kaibanjs@latest init ``` **2. Add your AI service API key to the `.env` file:** ``` VITE_OPENAI_API_KEY=your-api-key-here ``` **3. Restart your Kaiban Board:** ```bash npm run kaiban ``` ### Using Your Kaiban Board 1. Click "Start Workflow" to run the default example. 2. Watch agents complete tasks in real-time on the Task Board. 3. View the final output in the Results Overview. ## Flexible Integration > KaibanJS isn't limited to the Kaiban Board. You can integrate it directly into your projects, create custom UIs, or run agents without a UI. Explore our tutorials for [React](https://docs.kaibanjs.com/get-started/Tutorial:%20React%20+%20AI%20Agents) and [Node.js](https://docs.kaibanjs.com/get-started/Tutorial:%20Node.js%20+%20AI%20Agents) integration to unleash the full potential of KaibanJS in various development contexts. ## Manual Installation and Usage If you prefer to set up KaibanJS manually follow these steps: 1. Install KaibanJS via npm: ```bash npm install kaibanjs ``` 2. Import KaibanJS in your JavaScript file: ```js // Using ES6 import syntax for NextJS, React, etc. import { Agent, Task, Team } from 'kaibanjs'; ``` ```js // Using CommonJS syntax for NodeJS const { Agent, Task, Team } = require('kaibanjs'); ``` 3. Basic Usage Example ``` … ``` ## Basic Concepts **Agents** Agents are autonomous entities designed to perform specific roles and achieve goals based on the tasks assigned to them. They are like super-powered LLMs that can execute tasks in a loop until they arrive at the final answer. **Tasks** Tasks define the specific actions each agent must take, their expected outputs, and mark critical outputs as deliverables if they are the final products. **Team** The Team coordinates the agents and their tasks. It starts with an initial input and manages the flow of information between tasks. Watch this video to learn more about the concepts: [KaibanJS Concepts](https://youtu.be/VxfOIZLvBug?si=550uEiB3nriZ6trQ) ## Key Features The Kaiban Board Kanban boards are excellent tools for showcasing team workflows in real time, providing a clear and interactive snapshot of each member's progress. > We've adapted this concept for AI agents. Now, you can visualize the workflow of your AI agents as team members, with tasks moving from "To Do" to "Done" right before your eyes. This visual representation simplifies understanding and managing complex AI operations, making it accessible to anyone, anywhere. Role-Based Agent Design

Harness the power of specialization by configuring AI agents to excel in distinct, critical functions within your projects. This approach enhances the effectiveness and efficiency of each task, moving beyond the limitations of generic AI. In this example, our software development team is powered by three specialized AI agents: Dave, Ella, and Quinn. Each agent is expertly tailored to its specific role, ensuring efficient task handling and synergy that accelerates the development cycle.

```js import { Agent } from 'kaibanjs'; const daveLoper = new Agent({ name: 'Dave Loper', role: 'Developer', goal: 'Write and review code', background: 'Experienced in JavaScript, React, and Node.js', }); const ella = new Agent({ name: 'Ella', role: 'Product Manager', goal: 'Define product vision and manage roadmap', background: 'Skilled in market analysis and product strategy', }); const quinn = new Agent({ name: 'Quinn', role: 'QA Specialist', goal: 'Ensure quality and consistency', background: 'Expert in testing, automation, and bug tracking', }); ``` Tool Integration

Just as professionals use specific tools to excel in their tasks, enable your AI agents to utilize tools like search engines, calculators, and more to perform specialized tasks with greater precision and efficiency. In this example, one of the AI agents, Peter Atlas, leverages the Tavily Search Results tool to enhance his ability to select the best cities for travel. This tool allows Peter to analyze travel data considering weather, prices, and seasonality, ensuring the most suitable recommendations.

```js import { Agent, Tool } from 'kaibanjs'; const tavilySearchResults = new Tool({ name: 'Tavily Search Results', maxResults: 1, apiKey: 'ENV_TRAVILY_API_KEY', }); const peterAtlas = new Agent({ name: 'Peter Atlas', role: 'City Selector', goal: 'Choose the best city based on comprehensive travel data', background: 'Experienced in geographical data analysis and travel trends', tools: [tavilySearchResults], }); ``` _KaibanJS supports all LangchainJS-compatible tools, offering a versatile approach to tool integration. For further details, visit the [documentation](https://github.com/kaiban-ai/KaibanJS)._ Task Result Passing

Enable sophisticated workflows by passing results between tasks, allowing agents to build upon each other's work. This feature is essential for creating complex, multi-step processes where each task's output becomes input for subsequent tasks. In this example, a content creation team demonstrates how tasks can share and build upon results, creating a seamless workflow from research to final content production.

``` … ``` _Task results are automatically passed between tasks using the `{taskResult:taskN}` syntax, where N represents the task's position in the workflow (1-based indexing). For more details and advanced usage, visit our [Task Result Passing Guide](https://docs.kaibanjs.com/how-to/Task-Result-Passing)._ Memory Management

KaibanJS provides sophisticated memory management at the team level, giving you control over how task results flow through your workflows. This feature allows you to optimize performance and manage context in complex multi-agent systems. Here's an example of configuring team memory:

```js const team = new Team({ name: 'Content Creation Team', agents: [researcher, writer, editor], tasks: [researchTask, writingTask, editingTask], memory: true, // Enable automatic access to all previous task results }); // Or disable memory for explicit result management const performanceTeam = new Team({ name: 'High-Performance Team', agents: [analyst, processor], tasks: [analysisTask, processingTask], memory: false, // Require explicit result references }); ``` _For detailed information about memory management, visit our [documentation](https://docs.kaibanjs.com/core-concepts/08-Memory)._ Multiple LLMs Support

Optimize your AI solutions by integrating a range of specialized AI models, each tailored to excel in distinct aspects of your projects. In this example, the agents—Emma, Lucas, and Mia—use diverse AI models to handle specific stages of feature specification development. This targeted use of AI models not only maximizes efficiency but also ensures that each task is aligned with the most cost-effective and appropriate AI resources.

``` … ``` _For further details on integrating diverse AI models with KaibanJS, please visit the [documentation](https://github.com/kaiban-ai/KaibanJS)._ Robust State Management

KaibanJS employs a Redux-inspired architecture, enabling a unified approach to manage the states of AI agents, tasks, and overall flow within your applications. This method ensures consistent state management across complex agent interactions, providing enhanced clarity and control. Here's a simplified example demonstrating how to integrate KaibanJS with state management in a React application:

```js import myAgentsTeam from './agenticTeam'; const KaibanJSComponent = () => { const useTeamStore = myAgentsTeam.useStore(); const { agents, workflowResult } = useTeamStore((state) => ({ agents: state.agents, workflowResult: state.workflowResult, })); return ( ); }; export default KaibanJSComponent; ``` _For a deeper dive into state management with KaibanJS, visit the [documentation](https://github.com/kaiban-ai/KaibanJS)._ Integrate with Your Preferred JavaScript Frameworks

Easily add AI capabilities to your NextJS, React, Vue, Angular, and Node.js projects. KaibanJS is designed for seamless integration across a diverse range of JavaScript environments. Whether you're enhancing user interfaces in React, Vue, or Angular, building scalable applications with NextJS, or implementing server-side solutions in Node.js, the framework integrates smoothly into your existing workflow.

```js import React from 'react'; import myAgentsTeam from './agenticTeam'; const TaskStatusComponent = () => { const useTeamStore = myAgentsTeam.useStore(); const { tasks } = useTeamStore((state) => ({ tasks: state.tasks.map((task) => ({ id: task.id, description: task.descript