{"id":44753288,"url":"https://github.com/iqaicom/adk-ts-samples","last_synced_at":"2026-02-15T23:31:02.657Z","repository":{"id":324745480,"uuid":"1063975375","full_name":"IQAIcom/adk-ts-samples","owner":"IQAIcom","description":"A collection of sample agents built with ADK-TS (Agent Development Kit for Typescript)","archived":false,"fork":false,"pushed_at":"2026-01-28T15:14:37.000Z","size":496,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-28T21:33:43.068Z","etag":null,"topics":["adk","adk-sample","adk-ts","agent-samples","ai-agents","web3-app"],"latest_commit_sha":null,"homepage":"https://github.com/IQAIcom/adk-ts-samples","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IQAIcom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-25T11:19:27.000Z","updated_at":"2026-01-28T15:14:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/IQAIcom/adk-ts-samples","commit_stats":null,"previous_names":["iqaicom/adk-ts-samples"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/IQAIcom/adk-ts-samples","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fadk-ts-samples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fadk-ts-samples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fadk-ts-samples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fadk-ts-samples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IQAIcom","download_url":"https://codeload.github.com/IQAIcom/adk-ts-samples/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IQAIcom%2Fadk-ts-samples/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29492468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T19:29:10.908Z","status":"ssl_error","status_checked_at":"2026-02-15T19:29:10.419Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adk","adk-sample","adk-ts","agent-samples","ai-agents","web3-app"],"created_at":"2026-02-15T23:31:01.977Z","updated_at":"2026-02-15T23:31:02.652Z","avatar_url":"https://github.com/IQAIcom.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://files.catbox.moe/vumztw.png\" alt=\"ADK TypeScript Logo\" width=\"100\" /\u003e\n  \u003cbr/\u003e\n\n  \u003ch1\u003eADK-TS Samples\u003c/h1\u003e\n  \u003cb\u003eReal-world sample projects and agents built with ADK-TS (Agent Development Kit for TypeScript) to demonstrate framework capabilities and best practices.\u003c/b\u003e\n  \u003cbr /\u003e\n  \u003ci\u003eSample Projects • Agent Samples • Learning Resources\u003c/i\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/IQAIcom/adk-ts/blob/main/LICENSE.md\"\u003e\n      \u003cimg src=\"https://img.shields.io/npm/l/@iqai/adk\" alt=\"License\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/IQAIcom/adk-ts-samples\"\u003e\n      \u003cimg src=\"https://img.shields.io/github/stars/IQAIcom/adk-ts-samples?style=social\" alt=\"GitHub Stars\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n---\n\nWelcome 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.\n\n## ✨ Getting Started\n\nThis 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.\n\n\u003e [!IMPORTANT]  \n\u003e 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).\n\nTo 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).\n\n## 🌳 Repository Structure\n\n```text\n├── agents/                # Sample agent projects\n│   ├── README.md          # Setup and testing guide\n│   └── [sample-projects]/  # Individual example projects\n├── .github/               # GitHub templates and workflows\n└── README.md              # This file\n```\n\n## ℹ️ Getting Help\n\nIf 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).\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Node.js 18+\n- npm, yarn, or pnpm\n- TypeScript knowledge\n\n### Quick Start\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/IQAIcom/adk-ts-samples.git\n   cd adk-ts-samples\n   ```\n\n2. **Explore the samples**\n\n   ```bash\n   cd agents\n   # Follow the setup instructions in agents/README.md\n   ```\n\n3. **Run an example**\n\n   Each example includes its own setup and run instructions. Check the individual project directories for specific requirements.\n\n## 📚 Available Samples\n\n| Agent Name                  | Use Case                                                                                          | Learn                                                                                              | Tag                                     | Interaction Type | Complexity   | Agent Type   | Vertical        |\n| --------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------------------- | ---------------- | ------------ | ------------ | --------------- |\n| 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         |\n| 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         |\n| 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         |\n| 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         |\n| 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       |\n| 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 |\n\n## 🤝 Contributing\n\nWe welcome contributions! Whether you want to:\n\n- Add new sample projects\n- Improve existing samples\n- Fix bugs or issues\n- Enhance documentation\n\nPlease check out our [Contributing Guide](CONTRIBUTION.md) for detailed information on how to contribute to this repository.\n\n## 🌍 Community\n\nJoin our community to discuss ideas, ask questions, and share your projects:\n\n- [GitHub Discussions](https://github.com/IQAIcom/adk-ts/discussions)\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## ⚠️ Disclaimers\n\nThis project is intended for demonstration purposes only. It is not intended for use in a production environment.\n\n---\n\n**Ready to build your first AI agent?** Visit [https://adk.iqai.com](https://adk.iqai.com) to get started!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiqaicom%2Fadk-ts-samples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiqaicom%2Fadk-ts-samples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiqaicom%2Fadk-ts-samples/lists"}