{"id":30325845,"url":"https://github.com/timonwa/adk-task-agent","last_synced_at":"2026-04-19T07:34:48.128Z","repository":{"id":303492766,"uuid":"1015681873","full_name":"Timonwa/adk-task-agent","owner":"Timonwa","description":"An intelligent AI agent using ADK-TS (Agent Development Kit) from IQ AI and Next.js.","archived":false,"fork":false,"pushed_at":"2025-07-22T13:09:06.000Z","size":193,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-31T10:28:21.053Z","etag":null,"topics":["adk","adk-sample","adk-ts","ai","aiagent","aiagentsframework","iqai","nextjs","task-manager"],"latest_commit_sha":null,"homepage":"","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/Timonwa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"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-07-07T22:05:21.000Z","updated_at":"2025-07-07T22:20:59.000Z","dependencies_parsed_at":"2025-07-08T00:56:46.145Z","dependency_job_id":"8c902ba6-24c2-4d6a-92bb-dc58e3d2eae6","html_url":"https://github.com/Timonwa/adk-task-agent","commit_stats":null,"previous_names":["timonwa/adk-task-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Timonwa/adk-task-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Timonwa%2Fadk-task-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Timonwa%2Fadk-task-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Timonwa%2Fadk-task-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Timonwa%2Fadk-task-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Timonwa","download_url":"https://codeload.github.com/Timonwa/adk-task-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Timonwa%2Fadk-task-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31999092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","ai","aiagent","aiagentsframework","iqai","nextjs","task-manager"],"created_at":"2025-08-17T23:08:30.303Z","updated_at":"2026-04-19T07:34:48.088Z","avatar_url":"https://github.com/Timonwa.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Task Manager Agent with ADK-TS and Next.js\n\nThis is a Next.js application that demonstrates how to build an intelligent AI agent using ADK-TS (Agent Development Kit) from IQ AI. The project showcases a task management agent that can understand natural language commands, manage tasks, and maintain conversation context using localStorage for demo purposes.\n\nThis is the code demo for the blog post: **Building an AI Agent with ADK-TS and Next.js: A Step-by-Step Guide**.\n\nPlease give this repo a ⭐ if it was helpful to you.\n\n## Table of Contents\n\n- [AI Task Manager Agent with ADK-TS and Next.js](#ai-task-manager-agent-with-adk-ts-and-nextjs)\n  - [Table of Contents](#table-of-contents)\n  - [Demo](#demo)\n  - [Features](#features)\n  - [Prerequisites](#prerequisites)\n  - [Getting Started](#getting-started)\n  - [Tech Stack](#tech-stack)\n  - [License](#license)\n\n## Demo\n\n\u003cimg width=\"1352\" alt=\"Screenshot 2025-07-07 at 9 52 34 PM\" src=\"https://github.com/user-attachments/assets/e3bc3a63-eae1-4937-a0a2-9d8b96868c61\" /\u003e\n\n\n## Features\n\n- Intelligent task management through natural language conversation\n- Real-time AI responses powered by OpenAI GPT models\n- Task persistence using localStorage (demo) with automatic saving\n- Modern, responsive UI with dark mode support\n- Scrollable chat interface with auto-scroll to latest messages\n- Session management with ADK-TS framework\n\n## Prerequisites\n\n- Node.js (LTS version recommended)\n- OpenAI API key (or Anthropic/Google Gemini keys)\n- Basic knowledge of JavaScript/TypeScript and Next.js\n\n## Getting Started\n\n1. Clone the repository:\n\n```bash\ngit https://github.com/Timonwa/adk-task-agent.git\ncd adk-task-agent\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n# or\nyarn install\n```\n\n3. Create a .env.local file in the root directory and add your OpenAI API key:\n\n```\nOPENAI_API_KEY=your_openai_api_key\n```\n\nYou can also use Anthropic or Google Gemini keys by modifying the `agent.ts` file accordingly.\n\n4. Run the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\n5. Open [http://localhost:3000](http://localhost:3000) in your browser.\n\n## Tech Stack\n\n- [Next.js](https://nextjs.org/)\n- [ADK-TS](https://github.com/IQAIcom/adk-ts) - Agent Development Kit for TypeScript\n- [OpenAI](https://openai.com/) - LLM provider for AI responses\n- [Tailwind CSS](https://tailwindcss.com/)\n- [TypeScript](https://www.typescriptlang.org/)\n\n## Usage\n\nOnce the application is running, you can interact with the AI agent using natural language commands:\n\n- **Add tasks**: \"Add buy groceries to my list\" or \"Remember to call mom\"\n- **List tasks**: \"What are my current tasks?\" or \"Show me my to-do list\"\n- **Remove tasks**: \"Remove groceries\" or \"Delete call mom\"\n- **Clear all**: \"Clear all tasks\" or \"Reset my list\"\n\nThe agent will remember your tasks between sessions thanks to localStorage persistence.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE). See the LICENSE file for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimonwa%2Fadk-task-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimonwa%2Fadk-task-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimonwa%2Fadk-task-agent/lists"}