README.md

---
title: Rule-Based Task Planner
emoji: 📚
colorFrom: yellow
colorTo: yellow
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
short_description: Helps users break down high-level tasks into sub-steps
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# 📋 Rule-Based Task Planner

A simple rule-based AI agent that helps users break down high-level tasks into actionable substeps. Built with Python and Gradio, this project demonstrates a basic agentic AI workflow using hard-coded logic — no machine learning involved.

---

## 🚀 Demo

👉 [Launch the app on Hugging Face Spaces](https://huggingface.co/spaces/ujwal55/Rule-Based_Task_Planner)

---

## 🧠 What It Does

Enter a task like:

- `Plan a study session`
- `Plan a workout`
- `Plan a trip`
- `Plan a presentation`

And the app will return a predefined list of sub-tasks.

Example:

> **Input:** `Plan a study session`  
> **Output:**  
> 1. Choose a topic to study  
> 2. Gather necessary materials (books, notes, etc.)  
> 3. Allocate a time slot for the session  
> 4. Set specific goals  
> 5. Review notes and summarize key points

---

## 🛠 Tech Stack

- **Python**
- **Gradio** – For building a lightweight UI
- **Rule Engine** – Dictionary-based mapping of tasks to steps

---

## 🧩 Agentic AI Concept

Although there's no ML model here, this project mimics agentic behavior using a **hard-coded rule-based planner**:
- Maps user intent to structured outputs
- Provides a decision-like structure via a rule engine

This is ideal for beginners looking to build agentic systems without needing a large language model.

---

## 📁 File Structure
app.py # Main app with Gradio interface
task_plannings.py # It consist rule_engine description
README.md 
requirements.txt # gradio

---

## 🧪 Run Locally

1. Clone the repo:
```bash
git clone https://huggingface.co/spaces/ujwal55/Rule-Based_Task_Planner
cd Rule-Based_Task_Planner
```

2. Install dependencies:
pip install -r requirements.txt

3. Run the app:
python app.py

💡 Ideas to Extend
- Add a dropdown to choose common tasks
- Allow user-defined tasks with a fallback plan
- Use a small local LLM for few-shot task breakdowns

---

👨‍💻 Built by @ujwal55

Let me know if you want a more advanced version with a chatbot-style interface or LLM integration later.

---