# tarunteja-nagandla/ai-task-manager architecture

> Architecture diagram of the GitHub repository tarunteja-nagandla/ai-task-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tarunteja-nagandla/ai-task-manager
- Repository: https://github.com/tarunteja-nagandla/ai-task-manager

## Overview

This is a Streamlit natural-language task manager. A user submits a chat request; the UI passes it to a LangChain/LangGraph agent, which adds date context and can dispatch task CRUD tools, then returns a response to the chat. The tools persist tasks through SQLAlchemy in SQLite. The README also describes Groq-backed responses, in-memory agent checkpointing, task filtering, proactive completion detection, and chat-history controls. Source excerpts show the main calls and persistence path; the README documents the agent capabilities and integrations.

Main entry points: [`agent.py`](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py) (Agent runtime), [`database.py`](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/database.py) (Task ORM), [`app.py`](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/app.py) (Chat UI), [`tools.py`](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py) (Create task)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Chat interface"]
  node_chat_ui["Chat UI<br/>[app.py]"]
end

subgraph group_agent["Agent orchestration"]
  node_agent_runtime["Agent runtime<br/>[agent.py]"]
  node_date_context["Date context<br/>[agent.py]"]
  node_memory[("Agent memory<br/>[agent.py]")]
end

subgraph group_operations["Task operations"]
  node_create_task["Create task<br/>[tools.py]"]
  node_list_tasks["List and filter<br/>[tools.py]"]
  node_update_task["Update task<br/>[tools.py]"]
  node_delete_task["Delete task<br/>[tools.py]"]
end

subgraph group_persistence["Persistence"]
  node_orm["Task ORM<br/>[database.py]"]
  node_sqlite[("SQLite tasks<br/>[database.py]")]
end

node_user(("User"))
node_groq{{"Groq LLM"}}

node_user -->|"submits request"| node_chat_ui
node_chat_ui -->|"calls agent"| node_agent_runtime
node_chat_ui -->|"initializes schema"| node_orm
node_agent_runtime -->|"adds date"| node_date_context
node_agent_runtime -->|"configures checkpoint"| node_memory
node_agent_runtime -->|"queries model"| node_groq
node_agent_runtime -->|"dispatches tool"| node_create_task
node_agent_runtime -->|"dispatches tool"| node_list_tasks
node_agent_runtime -->|"dispatches tool"| node_update_task
node_agent_runtime -->|"dispatches tool"| node_delete_task
node_agent_runtime -->|"initializes schema"| node_orm
node_create_task -->|"creates task"| node_orm
node_list_tasks -->|"queries tasks"| node_orm
node_update_task -->|"updates task"| node_orm
node_delete_task -->|"deletes task"| node_orm
node_orm -->|"persists records"| node_sqlite

click node_chat_ui "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/app.py"
click node_agent_runtime "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py"
click node_date_context "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py"
click node_memory "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py"
click node_create_task "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py"
click node_list_tasks "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py"
click node_update_task "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py"
click node_delete_task "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py"
click node_orm "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/database.py"
click node_sqlite "https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/database.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat_ui,node_user toneBlue
class node_agent_runtime,node_date_context,node_memory toneAmber
class node_create_task,node_list_tasks,node_update_task,node_delete_task toneMint
class node_orm,node_sqlite toneRose
class node_groq toneIndigo
```

## Components

### Chat interface

- [Chat UI](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/app.py): `app.py`

### Agent orchestration

- [Agent runtime](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py): `agent.py`
- [Date context](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py): `agent.py`
- [Agent memory](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/agent.py): `agent.py`

### Task operations

- [Create task](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py): `tools.py`
- [List and filter](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py): `tools.py`
- [Update task](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py): `tools.py`
- [Delete task](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/tools.py): `tools.py`

### Persistence

- [Task ORM](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/database.py): `database.py`
- [SQLite tasks](https://github.com/tarunteja-nagandla/ai-task-manager/blob/main/database.py): `database.py`

### Other components

- **User**
- **Groq LLM**

## Connections

- User → Chat UI: submits request (evidence: `README.md`)
- Chat UI → Agent runtime: calls agent (evidence: `app.py`)
- Chat UI → Task ORM: initializes schema (evidence: `app.py`)
- Agent runtime → Date context: adds date (evidence: `agent.py`)
- Agent runtime → Agent memory: configures checkpoint (evidence: `agent.py`)
- Agent runtime → Groq LLM: queries model (evidence: `README.md`)
- Agent runtime → Create task: dispatches tool (evidence: `agent.py`)
- Agent runtime → List and filter: dispatches tool (evidence: `agent.py`)
- Agent runtime → Update task: dispatches tool (evidence: `agent.py`)
- Agent runtime → Delete task: dispatches tool (evidence: `agent.py`)
- Agent runtime → Task ORM: initializes schema (evidence: `agent.py`)
- Create task → Task ORM: creates task (evidence: `tools.py`)
- List and filter → Task ORM: queries tasks (evidence: `tools.py`)
- Update task → Task ORM: updates task (evidence: `tools.py`)
- Delete task → Task ORM: deletes task (evidence: `tools.py`)
- Task ORM → SQLite tasks: persists records (evidence: `database.py`)
