Skip to content

IQAIcom/adk-ts

Repository files navigation

ADK TypeScript Logo

ADK-TS: Agent Development Kit (ADK) for TypeScript

A comprehensive TypeScript framework for building sophisticated AI agents with multi-LLM support, advanced tools, and flexible conversation flows.

Production-ready • Multi-Agent Systems • Extensible Architecture

NPM Version NPM Downloads License GitHub Stars


🌟 Overview

The Agent Development Kit (ADK) for TypeScript provides a comprehensive framework for building sophisticated AI agents with multi-LLM support, advanced tool integration, memory systems, and flexible conversation flows. Built from the ground up for production use, ADK-TS enables developers to create intelligent, autonomous systems that can handle complex multi-step tasks.

🚀 Quick Start

Getting Started

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

Simple Example

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

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

console.log(response);

📚 Documentation

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

🚀 Key Features

🧪 Examples

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 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.

🤝 Contributing

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

🌍 Community

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

📜 License

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

🔒 Security

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!

About

A robust framework for building AI agents with multi-provider LLM support

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 13

Languages