# krishnatiwari005/auton8-agent architecture

> Architecture diagram of the GitHub repository krishnatiwari005/auton8-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/krishnatiwari005/auton8-agent
- Repository: https://github.com/krishnatiwari005/auton8-agent

## Overview

Auton8-Agent is a Streamlit chat client for an n8n-powered personal assistant. A user submits a natural-language request in the chat UI; the UI calls the callback provided by app.py, which POSTs JSON to the n8n webhook and returns the parsed response for display. The README documents the workflow’s AI Agent, memory, and tool integrations, but the workflow implementation is not present in the file tree, so those internal connections reflect documentation rather than inspected source.

Main entry points: [`ui.py`](https://github.com/krishnatiwari005/auton8-agent/blob/main/ui.py) (Chat UI), [`app.py`](https://github.com/krishnatiwari005/auton8-agent/blob/main/app.py) (App entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Chat interface"]
  node_chat_ui["Chat UI<br/>[ui.py]"]
end

subgraph group_client["Webhook client"]
  node_app["App entry<br/>[app.py]"]
end

subgraph group_workflow["n8n workflow"]
  node_webhook["Webhook"]
  node_agent["AI Agent"]
  node_memory[("Simple Memory")]
  node_respond["Respond to Webhook"]
end

subgraph group_tools["Agent tools"]
  node_search["Google Search"]
  node_calculator["Calculator"]
  node_gmail["Gmail"]
  node_calendar["Calendar"]
  node_tasks["Tasks"]
  node_notes["Notes"]
  node_expenses["Expenses"]
end

node_user(("User"))

node_user -->|"enters request"| node_chat_ui
node_chat_ui -->|"calls callback"| node_app
node_app -->|"POSTs JSON"| node_webhook
node_webhook -->|"forwards message"| node_agent
node_agent -->|"uses context"| node_memory
node_agent -.->|"dispatches lookup"| node_search
node_agent -.->|"dispatches calculation"| node_calculator
node_agent -.->|"dispatches email actions"| node_gmail
node_agent -.->|"dispatches calendar actions"| node_calendar
node_agent -.->|"dispatches task actions"| node_tasks
node_agent -.->|"dispatches note actions"| node_notes
node_agent -.->|"dispatches expense actions"| node_expenses
node_agent -->|"returns answer"| node_respond
node_respond -->|"sends JSON"| node_app
node_app -->|"returns reply"| node_chat_ui
node_chat_ui -->|"displays reply"| node_user

click node_chat_ui "https://github.com/krishnatiwari005/auton8-agent/blob/main/ui.py"
click node_app "https://github.com/krishnatiwari005/auton8-agent/blob/main/app.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_app toneAmber
class node_webhook,node_agent,node_memory,node_respond toneMint
class node_search,node_calculator,node_gmail,node_calendar,node_tasks,node_notes,node_expenses toneRose
```

## Components

### Chat interface

- [Chat UI](https://github.com/krishnatiwari005/auton8-agent/blob/main/ui.py): `ui.py`

### Webhook client

- [App entry](https://github.com/krishnatiwari005/auton8-agent/blob/main/app.py): `app.py`

### n8n workflow

- **Webhook**
- **AI Agent**
- **Simple Memory**
- **Respond to Webhook**

### Agent tools

- **Google Search**
- **Calculator**
- **Gmail**
- **Calendar**
- **Tasks**
- **Notes**
- **Expenses**

### Other components

- **User**

## Connections

- User → Chat UI: enters request
- Chat UI → App entry: calls callback
- App entry → Webhook: POSTs JSON
- Webhook → AI Agent: forwards message
- AI Agent → Simple Memory: uses context
- AI Agent → Google Search: dispatches lookup
- AI Agent → Calculator: dispatches calculation
- AI Agent → Gmail: dispatches email actions
- AI Agent → Calendar: dispatches calendar actions
- AI Agent → Tasks: dispatches task actions
- AI Agent → Notes: dispatches note actions
- AI Agent → Expenses: dispatches expense actions
- AI Agent → Respond to Webhook: returns answer
- Respond to Webhook → App entry: sends JSON
- App entry → Chat UI: returns reply
- Chat UI → User: displays reply