https://github.com/timonwa/adk-task-agent
An intelligent AI agent using ADK-TS (Agent Development Kit) from IQ AI and Next.js.
https://github.com/timonwa/adk-task-agent
adk adk-sample adk-ts ai aiagent aiagentsframework iqai nextjs task-manager
Last synced: about 2 months ago
JSON representation
An intelligent AI agent using ADK-TS (Agent Development Kit) from IQ AI and Next.js.
- Host: GitHub
- URL: https://github.com/timonwa/adk-task-agent
- Owner: Timonwa
- License: mit
- Created: 2025-07-07T22:05:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-07T22:18:23.000Z (3 months ago)
- Last Synced: 2025-07-08T00:55:11.910Z (3 months ago)
- Topics: adk, adk-sample, adk-ts, ai, aiagent, aiagentsframework, iqai, nextjs, task-manager
- Language: TypeScript
- Homepage:
- Size: 101 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AI Task Manager Agent with ADK-TS and Next.js
This 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.
This is the code demo for the blog post: **Building an AI Agent with ADK-TS and Next.js: A Step-by-Step Guide**.
Please give this repo a ⭐ if it was helpful to you.
## Table of Contents
- [AI Task Manager Agent with ADK-TS and Next.js](#ai-task-manager-agent-with-adk-ts-and-nextjs)
- [Table of Contents](#table-of-contents)
- [Demo](#demo)
- [Features](#features)
- [Prerequisites](#prerequisites)
- [Getting Started](#getting-started)
- [Tech Stack](#tech-stack)
- [License](#license)
## Demo
## Features
- Intelligent task management through natural language conversation
- Real-time AI responses powered by OpenAI GPT models
- Task persistence using localStorage (demo) with automatic saving
- Modern, responsive UI with dark mode support
- Scrollable chat interface with auto-scroll to latest messages
- Session management with ADK-TS framework
## Prerequisites
- Node.js (LTS version recommended)
- OpenAI API key (or Anthropic/Google Gemini keys)
- Basic knowledge of JavaScript/TypeScript and Next.js
## Getting Started
1. Clone the repository:
```bash
git https://github.com/Timonwa/adk-task-agent.git
cd adk-task-agent
```
2. Install dependencies:
```bash
npm install
# or
yarn install
```
3. Create a .env.local file in the root directory and add your OpenAI API key:
```
OPENAI_API_KEY=your_openai_api_key
```
You can also use Anthropic or Google Gemini keys by modifying the `agent.ts` file accordingly.
4. Run the development server:
```bash
npm run dev
# or
yarn dev
```
5. Open [http://localhost:3000](http://localhost:3000) in your browser.
## Tech Stack
- [Next.js](https://nextjs.org/)
- [ADK-TS](https://github.com/IQAIcom/adk-ts) - Agent Development Kit for TypeScript
- [OpenAI](https://openai.com/) - LLM provider for AI responses
- [Tailwind CSS](https://tailwindcss.com/)
- [TypeScript](https://www.typescriptlang.org/)
## Usage
Once the application is running, you can interact with the AI agent using natural language commands:
- **Add tasks**: "Add buy groceries to my list" or "Remember to call mom"
- **List tasks**: "What are my current tasks?" or "Show me my to-do list"
- **Remove tasks**: "Remove groceries" or "Delete call mom"
- **Clear all**: "Clear all tasks" or "Reset my list"
The agent will remember your tasks between sessions thanks to localStorage persistence.
## License
This project is licensed under the [MIT License](LICENSE). See the LICENSE file for more information.