🎯 Taskify

AI-Powered Task Management with Agentic Automation

The hybrid task management platform where AI automation meets manual control.

🎬 Watch Demo • ✨ Features • 🛠️ Tech Stack • 🚀 Quick Start

---

🎬 Demo

Live Application: https://taskify.click

Tip

Secured with HTTPS - The application uses Let's Encrypt SSL certificates for secure communication.

---

✨ Features

🤖 Agentic AI Automation

• Natural Language Task Management - Create, update, complete, and delete tasks through conversation
• OpenAI Agents SDK - Powered by the latest agentic AI framework
• Real-time Streaming - Instant responses with Server-Sent Events (SSE)

📋 Hybrid Control

• Dual-Pane Interface - Chat with AI on the right, manage tasks manually on the left
• Priority & Tags - Organize with high/medium/low priority and custom tags
• Due Dates & Reminders - Never miss a deadline
• Recycle Bin - Soft delete with easy recovery

🔐 Enterprise-Ready

• Secure Authentication - Google OAuth + Email/Password via Better Auth
• Multi-Tenant Architecture - Strict user data isolation
• Cloud Native - Deployed on Oracle Kubernetes Engine (OKE)

---

🛠️ Tech Stack

Layer	Technology
Frontend	Next.js 16, React 19, TypeScript, TailwindCSS
AI Chat	OpenAI ChatKit, Agents SDK v0.6+
Backend	FastAPI, Python 3.12+, SQLModel
Database	Neon PostgreSQL (Serverless)
Auth	Better Auth (Google OAuth + Email)
Infra	Docker, Kubernetes (OKE), Helm

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│ Frontend │
│ ┌─────────────────┐ ┌────────────────────────────────┐ │
│ │ Task Sidebar │ │ ChatKit AI Interface │ │
│ │ (Manual CRUD) │◄──►│ (Natural Language Tasks) │ │
│ └────────┬────────┘ └──────────────┬─────────────────┘ │
└───────────┼────────────────────────────┼────────────────────┘
│ │
▼ ▼
┌─────────────────────────────────────────────────────────────┐
│ FastAPI Backend │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ REST API │ │ MCP Server │ │ OpenAI Agent │ │
│ │ /api/tasks │ │ (Tools) │◄─┤ (Orchestrator) │ │
│ └──────┬───────┘ └──────────────┘ └──────────────────┘ │
└─────────┼───────────────────────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────────┐
│ Neon PostgreSQL (Serverless) │
│ ┌──────────┐ ┌──────────┐ ┌────────────────────────────┐ │
│ │ Users │ │ Tasks │ │ Conversations & Messages │ │
│ └──────────┘ └──────────┘ └────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

---

🚀 Quick Start

Prerequisites

• Docker & Docker Compose
• Node.js 18+ (for local development)
• Python 3.12+ (for local development)

Run with Docker

# Clone the repository
git clone https://github.com/DevHammad0/todo-ai-chatbot.git
cd todo-ai-chatbot
# Configure environment
cp .env.example .env
# Edit .env with your API keys# Start all services
docker-compose up

Access the app at: http://localhost:3000

Environment Variables

# RequiredOPENAI_API_KEY=sk-...DATABASE_URL=postgresql://...BETTER_AUTH_SECRET=your-secret-key# Google OAuth (optional)GOOGLE_CLIENT_ID=...GOOGLE_CLIENT_SECRET=...

---

📁 Project Structure

taskify/
├── frontend/ # Next.js 16 App
│ ├── app/ # App Router pages
│ ├── components/ # React components
│ └── lib/ # Utilities & auth
├── backend/ # FastAPI Backend
│ ├── app/ # Application code
│ │ ├── api/ # REST endpoints
│ │ ├── agent/ # OpenAI Agent
│ │ ├── mcp/ # MCP Server & Tools
│ │ └── models/ # Database models
│ └── tests/ # Backend tests
├── helm/ # Kubernetes Helm charts
└── docs/ # Documentation

---

🌐 Deployment

Taskify is deployed on Oracle Cloud Infrastructure (OCI) using:

• Oracle Kubernetes Engine (OKE) - Container orchestration
• OCI Container Registry (OCIR) - Docker image storage
• Neon PostgreSQL - Serverless database
• GitHub Actions - CI/CD pipeline

---

👨‍💻 Author

Hammad - @DevHammad0

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ for the AI Hackathon

Powered by OpenAI Agents SDK & Neon PostgreSQL