AI Toolkit

Installation

Install AI Toolkit and configure peer dependencies

Install the Package

npm install @jamaalbuilds/ai-toolkit
yarn add @jamaalbuilds/ai-toolkit
pnpm add @jamaalbuilds/ai-toolkit

The core package includes all modules. Peer dependencies are only needed for the modules you use.

Peer Dependencies

Each module wraps an underlying library. Install only the peer deps for the modules you use:

AI (generate, stream, structured output)

npm install ai @ai-sdk/groq
yarn add ai @ai-sdk/groq
pnpm add ai @ai-sdk/groq

Or use OpenRouter for access to multiple providers:

npm install ai @openrouter/ai-sdk-provider
yarn add ai @openrouter/ai-sdk-provider
pnpm add ai @openrouter/ai-sdk-provider

Chain (prompt templates, output parsing)

npm install @langchain/core @langchain/textsplitters
yarn add @langchain/core @langchain/textsplitters
pnpm add @langchain/core @langchain/textsplitters

Agents (multi-agent orchestration)

npm install @langchain/langgraph @langchain/core
yarn add @langchain/langgraph @langchain/core
pnpm add @langchain/langgraph @langchain/core
npm install @llamaindex/liteparse
yarn add @llamaindex/liteparse
pnpm add @llamaindex/liteparse
npm install drizzle-orm postgres
yarn add drizzle-orm postgres
pnpm add drizzle-orm postgres

Monitor (tracing, evaluation)

npm install langfuse
yarn add langfuse
pnpm add langfuse

Workflow (background jobs, cron)

npm install inngest
yarn add inngest
pnpm add inngest

MCP (Model Context Protocol servers)

npm install @modelcontextprotocol/sdk zod
yarn add @modelcontextprotocol/sdk zod
pnpm add @modelcontextprotocol/sdk zod

Cache (Redis adapter)

npm install ioredis
yarn add ioredis
pnpm add ioredis

Storage (file uploads)

npm install @vercel/blob
yarn add @vercel/blob
pnpm add @vercel/blob

TypeScript Configuration

AI Toolkit is ESM-only. Your tsconfig.json should include:

{
  "compilerOptions": {
    "module": "esnext",
    "moduleResolution": "bundler",
    "target": "es2022"
  }
}

Environment Variables

Configure your AI provider credentials:

# .env
GROQ_API_KEY=gsk_...
# or
OPENROUTER_API_KEY=sk-or-...
# or
OPENAI_API_KEY=sk-...

Verify Installation

import { initToolkit } from '@jamaalbuilds/ai-toolkit/config';

initToolkit();
console.log('AI Toolkit is ready!');
On this page

On this page