BRAIIN is an AI-powered tool orchestrator that intelligently selects and combines API calls, database queries, and external tools to achieve complex tasks.
Inspired by systems like J.A.R.V.I.S., BRAIIN enables autonomous reasoning to determine the best execution path for a given request.
- 🏗 Tool Orchestration – Dynamically chooses the best tools (APIs, databases, system commands) for a task.
- 🔄 Multi-Step Reasoning – Can combine multiple tools to solve complex problems.
- 🧠 LLM-Powered Decision Making – Uses large language models (LLMs) to analyze and optimize tool usage.
- 🔌 Flexible & Extendable – Easily add custom tools for specific use cases.
- ⚡ Real-Time Execution – Executes tasks efficiently with minimal latency.
npm install braiinBRAIIN is based on the concept of an Orchestrator and one or multiple Agents that have each one or multiple Tools.
- A tool is an object that has a tag, a description, an input and an output fields. It's purpose is to achieve a given specific goal like writing a file.
- An agent is an object that has a tag, a description and a list of tools. Each agent is specialised in a specific topic (math, management, handling files, ...) and has a set of tools (write file, read file, ...) that can be used to achieve a specific goal.
- An orchestrator is an object that has a set of agents that are each specialised in a specific topic. The orchestrator is the one that orchestrate the execution of the tools based on the user's request. It is the one that chooses which agent to use and which tool to use, he is capable of combining the tools to achieve the best result.
// user.retriever.tool.ts
import { Tool } from 'braiin';
const users = [
{
name: 'User 1',
age: 25,
email: 'user1@example.com'
},
{
name: 'User 2',
age: 30,
email: 'user2@example.com'
},
{
name: 'User 3',
age: 35,
email: 'user3@example.com'
}
]
export const userRetrieverTool: Tool = {
tag: 'user-retriever',
description: `Retrieve a user informations from its name`,
input: 'The user\'s name',
output: 'A json object containing the user\'s informations if the user was found, an empty string otherwise',
call: async (userName?: string) => {
const user = users.find(user => user.name === userName)
return user ? JSON.stringify(user) : ''
}
}// user.birth.tool.ts
import { Tool } from 'braiin';
export const userBirthYearTool: Tool = {
tag: 'user-birth-year',
description: `Compute the birth year of a user from its age`,
input: 'The user\'s age',
output: 'A number representing the user\'s birth year',
call: async (age?: string) => {
const date = new Date()
const year = date.getFullYear()
const ageAsNumber = age ? parseInt(age) : year
return `${year - ageAsNumber}`
}
}// index.ts
import { userRetrieverTool } from './user.retriever.tool.ts';
import { userBirthYearTool } from './user.birth.tool.ts';
import { Agent, Orchestrator } from 'braiin';
const userAgent = new Agent(
'user-agent',
'You are a useful assistant that answers questions about users.',
[
userRetrieverTool,
userBirthYearTool
]
)
const orchestrator = new Orchestrator(
[userAgent],
{
apiKey: "your api key",
model: "gpt-4o",
serverUrl: "https://api.openai.com/v1/chat/completions",
temperature: 0
}
)
const answer = await orchestrator.executeTask(
"When was User 1 born?"
)
console.log(answer); // User 1 was born in 1998