Agentuity TypeScript SDK

Visit https://agentuity.com to get started with Agentuity.

The Agentuity TypeScript SDK is a powerful toolkit for building, deploying, and managing AI agents in Node.js and Bun environments. This SDK provides developers with a comprehensive set of tools to create intelligent, event-driven agents that can process various types of content, communicate with each other, and integrate with external systems.

Key Features

• Multi-Agent Architecture: Build and orchestrate multiple interconnected agents that can communicate and collaborate.
• Event-Driven Design: Respond to various triggers including webhooks, cron jobs, SMS, voice, email, and more.
• Rich Content Handling: Process and generate multiple content types including JSON, text, markdown, HTML, and binary formats (images, audio, PDFs).
• Persistent Storage: Built-in key-value and vector storage capabilities for maintaining state and performing semantic searches.
• Observability: Integrated OpenTelemetry support for comprehensive logging, metrics, and tracing.
• Cross-Runtime Support: Works seamlessly with both Node.js and Bun runtimes.

Use Cases

• Building conversational AI systems
• Creating automated workflows with multiple specialized agents
• Developing content processing and generation pipelines
• Implementing intelligent data processing systems
• Building AI-powered APIs and services

Getting Started

To use this SDK in a real project, you should install the Agentuity CLI.

Mac OS

brew tap agentuity/tap && brew install agentuity

Linux or Windows

See the Agentuity CLI repository for installation instructions and releases.

Once installed, you can create a new project with the following command:

agentuity new

Development Setup

Prerequisites

• Node.js (v22 or higher)
• Bun (latest version recommended)
• TypeScript (v5 or higher)

Installation

Clone the repository and install dependencies:

# Clone the repository
git clone https://github.com/agentuity/sdk-js.git
cd sdk-js

# Install dependencies using Bun (recommended)
bun install

# Or using npm
npm install

Building the SDK

# Using Bun (recommended)
bun run build

# Or using npm
npm run build

The build output will be in the dist directory.

Testing

Run tests with Bun or npm:

# Bun
bun test

# npm
npm test

Making Changes

To make changes for this repo, do the following in your PR:

npm run changeset

And if you plan to release in the same PR, run:

npm run version

Also run (only if you ran npm run version):

npm install

Then commit all files in the PR. When you merge the PR it will release the SDK.

License

See the LICENSE file for details.

More detailed docs

• Creating new IO
• Local SDK testing