https://github.com/iqaicom/adk-ts
A robust framework for building AI agents with multi-provider LLM support
https://github.com/iqaicom/adk-ts
adk agents agents-sdk ai ai-agents
Last synced: 4 months ago
JSON representation
A robust framework for building AI agents with multi-provider LLM support
- Host: GitHub
- URL: https://github.com/iqaicom/adk-ts
- Owner: IQAIcom
- License: mit
- Created: 2025-05-08T07:16:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-28T20:06:32.000Z (5 months ago)
- Last Synced: 2026-01-28T23:44:33.927Z (5 months ago)
- Topics: adk, agents, agents-sdk, ai, ai-agents
- Language: TypeScript
- Homepage: https://adk.iqai.com
- Size: 14 MB
- Stars: 117
- Watchers: 1
- Forks: 17
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
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
---
## 🌟 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:**
```bash
npm install -g @iqai/adk-cli
adk
```
- **Add ADK-TS to an existing project:**
```bash
npm install @iqai/adk
```
### Simple Example
```typescript
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](https://adk.iqai.com/docs/framework/get-started).
## 🚀 Key Features
- **🤖 [Multi-Provider LLM Support](https://adk.iqai.com/docs/framework/agents/models)** - Seamlessly integrate OpenAI, Anthropic, Google, and other leading providers
- **🛠️ [Extensible Tool System](https://adk.iqai.com/docs/framework/tools)** - Define custom tools with declarative schemas for intelligent LLM integration
- **🧠 [Advanced Agent Reasoning](https://adk.iqai.com/docs/framework/agents/custom-agents)** - Complete reasoning loop implementation for complex task execution
- **⚡ [Real-Time Streaming](https://adk.iqai.com/docs/framework/events/streaming)** - Support for streaming responses and dynamic user interactions
- **🔐 [Flexible Authentication](https://adk.iqai.com/docs/framework/events/event-actions#authentication-requests)** - Secure agent API access with multiple auth mechanisms
- **💾 [Persistent Memory Systems](https://adk.iqai.com/docs/framework/sessions/state)** - Context retention and learning from past interactions
- **🔄 [Multi-Agent Orchestration](https://adk.iqai.com/docs/framework/agents/workflow-agents)** - Sequential, parallel, and loop-based agent workflows
- **🖥️ [Prebuilt MCP servers](https://adk.iqai.com/docs/mcp-servers)** - Easily deploy and manage your agents with our prebuilt MCP servers
## 🧪 Examples
For examples of how to use ADK-TS, check out the [`apps/examples`](https://github.com/IQAIcom/adk-ts/tree/main/apps/examples) directory.
You can run the examples by following these steps:
```bash
# 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](https://makersuite.google.com/app/apikey).
## 🤝 Contributing
All contributions are welcome! Please check out our [Contributing Guide](CONTRIBUTION.md) for details on how to get started.
## 🌍 Community
Join our community to discuss ideas, ask questions, and share your projects:
- [GitHub Discussions](https://github.com/IQAIcom/adk-ts/discussions)
## 📜 License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
## 🔒 Security
If you discover a security vulnerability within this project, please report it by following our [Security Policy](SECURITY.md). We take security seriously and will respond promptly to any reports.
---
**Ready to build your first AI agent?** Visit [https://adk.iqai.com](https://adk.iqai.com) to get started!