https://github.com/iqaicom/adk-ts-samples
A collection of sample agents built with ADK-TS (Agent Development Kit for Typescript)
https://github.com/iqaicom/adk-ts-samples
adk adk-sample adk-ts agent-samples ai-agents web3-app
Last synced: 4 months ago
JSON representation
A collection of sample agents built with ADK-TS (Agent Development Kit for Typescript)
- Host: GitHub
- URL: https://github.com/iqaicom/adk-ts-samples
- Owner: IQAIcom
- License: mit
- Created: 2025-09-25T11:19:27.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-01-28T15:14:37.000Z (5 months ago)
- Last Synced: 2026-01-28T21:33:43.068Z (5 months ago)
- Topics: adk, adk-sample, adk-ts, agent-samples, ai-agents, web3-app
- Language: TypeScript
- Homepage: https://github.com/IQAIcom/adk-ts-samples
- Size: 484 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
ADK-TS Samples
Real-world sample projects and agents built with ADK-TS (Agent Development Kit for TypeScript) to demonstrate framework capabilities and best practices.
Sample Projects âĸ Agent Samples âĸ Learning Resources
---
Welcome to the ADK-TS Samples repository! This collection provides ready-to-use sample projects and agents built with the [Agent Development Kit (ADK) for TypeScript](https://adk.iqai.com), designed to demonstrate real-world use cases and accelerate your development process. These samples cover a range of complexities, from simple conversational agents to complex multi-agent workflows.
## ⨠Getting Started
This repository contains ADK-TS sample agents and projects. Navigate to the **[agents/](agents/)** folder to see setup instructions and learn more about the available samples.
> [!IMPORTANT]
> The samples in this repository are built using **ADK-TS (Agent Development Kit for TypeScript)**. Before you can run any of the samples, you must have ADK-TS installed. For instructions, please refer to the [**ADK-TS Installation Guide**](https://adk.iqai.com/docs/framework/get-started/installation).
To learn more, check out the [ADK-TS Documentation](https://adk.iqai.com/docs), and the main [ADK-TS GitHub repository](https://github.com/IQAIcom/adk-ts).
## đŗ Repository Structure
```text
âââ agents/ # Sample agent projects
â âââ README.md # Setup and testing guide
â âââ [sample-projects]/ # Individual example projects
âââ .github/ # GitHub templates and workflows
âââ README.md # This file
```
## âšī¸ Getting Help
If you have any questions or if you found any problems with this repository, please report through [GitHub issues](https://github.com/IQAIcom/adk-ts-samples/issues).
## đ Getting Started
### Prerequisites
- Node.js 18+
- npm, yarn, or pnpm
- TypeScript knowledge
### Quick Start
1. **Clone the repository**
```bash
git clone https://github.com/IQAIcom/adk-ts-samples.git
cd adk-ts-samples
```
2. **Explore the samples**
```bash
cd agents
# Follow the setup instructions in agents/README.md
```
3. **Run an example**
Each example includes its own setup and run instructions. Check the individual project directories for specific requirements.
## đ Available Samples
| Agent Name | Use Case | Learn | Tag | Interaction Type | Complexity | Agent Type | Vertical |
| --------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------- | ---------------- | ------------ | ------------ | --------------- |
| Research Assistant | Web research with targeted searches, analysis generation, and comprehensive report writing | State management, Parallel workflows, Tool integration, Multi-agent orchestration | `research`, `analysis` | Conversational | Intermediate | Multi-agent | General |
| ATP Micropayment Agent | AI agent with monetized API endpoints and web server using x402 protocol for payment handling | API proxying, Payment middleware, x402 integration | `monetization`, `payments`, `api` | REST API + Agent | Intermediate | Agentic API | General |
| Telegram Personal Assistant | Personal productivity assistant managing reminders and shopping lists with Telegram notifications | Multi-agent architecture, Telegram integration, Persistent state management, Notification services | `productivity`, `telegram`, `reminders` | Conversational | Intermediate | Multi-agent | General |
| Crypto Tax Agent | On-chain transaction analysis, tax event classification, and tax report generation | Blockchain integration, Cost basis calculation, Report generation, Session state management | `crypto`, `tax`, `blockchain`, `defi` | Conversational | Intermediate | Single Agent | Finance |
| DeBank Portfolio Analyzer | Multi-chain portfolio analysis using DeBank data (balances, tokens, protocols, NFTs); debank-mcp adoption | MCP integration, debank-mcp, McpToolset, DeBank API, Single-agent tool orchestration | `portfolio`, `debank`, `mcp`, `defi` | Conversational | Intermediate | Single Agent | Web3/DeFi |
| DAO Proposal Analyzer | Multi-chain DAO proposal analysis and voting recommendations (Ethereum + Fraxtal L2) | Sequential agents, Multi-chain viem integration, Governance analysis, Multi-agent orchestration | `dao`, `governance`, `web3`, `voting` | Workflow | Advanced | Multi-agent | Web3/Governance |
## đ¤ Contributing
We welcome contributions! Whether you want to:
- Add new sample projects
- Improve existing samples
- Fix bugs or issues
- Enhance documentation
Please check out our [Contributing Guide](CONTRIBUTION.md) for detailed information on how to contribute to this repository.
## đ 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](LICENSE) file for details.
## â ī¸ Disclaimers
This project is intended for demonstration purposes only. It is not intended for use in a production environment.
---
**Ready to build your first AI agent?** Visit [https://adk.iqai.com](https://adk.iqai.com) to get started!