ADK-TS: The TypeScript-Native AI Agent Framework

An open-source framework for building production-ready AI agents in TypeScript. Type-safe, multi-LLM, with built-in tools, sessions, and agent orchestration.
TypeScript-Native • Multi-Agent Systems • Production-Ready

🌟 Overview

ADK-TS is the TypeScript-native framework for building production-ready AI agents. It provides multi-LLM support, advanced tool integration, memory systems, and flexible conversation flows — built from the ground up for TypeScript developers who want to ship intelligent, autonomous systems that handle complex multi-step tasks.

You can get started in two ways:

• Create a new project with our CLI:

  npm install -g @iqai/adk-cli
  adk

• Add ADK-TS to an existing project:

  npm install @iqai/adk

import { AgentBuilder } from "@iqai/adk";

const response = await AgentBuilder.withModel("gemini-2.5-flash").ask(
  "What is the capital of France?",
);

console.log(response);

For detailed documentation on how to use ADK-TS, please visit our official documentation site.

• 🤖 Multi-Provider LLM Support - Seamlessly integrate OpenAI, Anthropic, Google, and other leading providers
• 🛠️ Extensible Tool System - Define custom tools with declarative schemas for intelligent LLM integration
• 🧠 Advanced Agent Reasoning - Complete reasoning loop implementation for complex task execution
• ⚡ Real-Time Streaming - Support for streaming responses and dynamic user interactions
• 🔐 Flexible Authentication - Secure agent API access with multiple auth mechanisms
• 💾 Persistent Memory Systems - Context retention and learning from past interactions
• 🔄 Multi-Agent Orchestration - Sequential, parallel, and loop-based agent workflows
• 🖥️ Prebuilt MCP servers - Easily deploy and manage your agents with our prebuilt MCP servers

For examples of how to use ADK-TS, check out the apps/examples directory.

You can run the examples by following these steps:

# 1. Clone and install the repository
git clone https://github.com/IQAIcom/adk-ts.git
cd adk-ts
pnpm install

# 2. Build the ADK-TS package (required for examples to work)
pnpm build

# 3. Setup API keys
cd apps/examples
echo "GOOGLE_API_KEY=your_google_api_key_here" > .env

# 4. Run examples
pnpm start

⚠️ Important: The examples require API keys from at least one LLM provider. The default LLM is Google Gemini. You can get a Google API key from Google AI Studio.

All contributions are welcome! Please check out our Contributing Guide for details on how to get started.

Join our community to discuss ideas, ask questions, and share your projects:

• GitHub Discussions

This project is licensed under the MIT License - see the LICENSE.md file for details.

If you discover a security vulnerability within this project, please report it by following our Security Policy. We take security seriously and will respond promptly to any reports.

Ready to build your first AI agent? Visit https://adk.iqai.com to get started!