Installation
Install AI Toolkit and configure peer dependencies
Install the Package
npm install @jamaalbuilds/ai-toolkityarn add @jamaalbuilds/ai-toolkitpnpm add @jamaalbuilds/ai-toolkitThe 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/groqyarn add ai @ai-sdk/groqpnpm add ai @ai-sdk/groqOr use OpenRouter for access to multiple providers:
npm install ai @openrouter/ai-sdk-provideryarn add ai @openrouter/ai-sdk-providerpnpm add ai @openrouter/ai-sdk-providerChain (prompt templates, output parsing)
npm install @langchain/core @langchain/textsplittersyarn add @langchain/core @langchain/textsplitterspnpm add @langchain/core @langchain/textsplittersAgents (multi-agent orchestration)
npm install @langchain/langgraph @langchain/coreyarn add @langchain/langgraph @langchain/corepnpm add @langchain/langgraph @langchain/coreKnowledge (document ingestion, search)
npm install @llamaindex/liteparseyarn add @llamaindex/liteparsepnpm add @llamaindex/liteparseDatabase (typed queries, vector search)
npm install drizzle-orm postgresyarn add drizzle-orm postgrespnpm add drizzle-orm postgresMonitor (tracing, evaluation)
npm install langfuseyarn add langfusepnpm add langfuseWorkflow (background jobs, cron)
npm install inngestyarn add inngestpnpm add inngestMCP (Model Context Protocol servers)
npm install @modelcontextprotocol/sdk zodyarn add @modelcontextprotocol/sdk zodpnpm add @modelcontextprotocol/sdk zodCache (Redis adapter)
npm install ioredisyarn add ioredispnpm add ioredisStorage (file uploads)
npm install @vercel/blobyarn add @vercel/blobpnpm add @vercel/blobTypeScript 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!');