# siddeshhallale07/aether-ai architecture

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

- Interactive diagram: https://gitdiagram.com/siddeshhallale07/aether-ai
- Repository: https://github.com/siddeshhallale07/aether-ai

## Overview

Aether Copilot AI is a data-analysis platform: users manage projects, upload datasets, assess quality, clean versioned data, analyze and visualize it, discover patterns, ask an AI copilot for context-aware explanations, and generate reports. The frontend exposes these capabilities through routed pages and an API client; the FastAPI backend provides domain engines and persistence. The README documents the product workflow and capabilities, but many endpoint and engine implementations were not sampled, so some domain links rely on that documentation rather than inspected calls.

Main entry points: [`backend/app/analytics/engine.py`](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/analytics/engine.py) (Statistical analytics), [`frontend/src/routes/AppRoutes.tsx`](https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/routes/AppRoutes.tsx) (Application routes), [`frontend/src/pages/WorkspacePage.tsx`](https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/pages/WorkspacePage.tsx) (Workspace UI), [`backend/app/api/v1/api.py`](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/api/v1/api.py) (API router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User workspace"]
  node_routes["Application routes<br/>[AppRoutes.tsx]"]
  node_workspace["Workspace UI<br/>[WorkspacePage.tsx]"]
  node_feature_pages["Feature pages"]
  node_workspace_state["Workspace state"]
end

subgraph group_api["API and services"]
  node_api_client["API client<br/>[api.ts]"]
  node_api_router["API router<br/>[api.py]"]
  node_endpoints["Feature endpoints"]
end

subgraph group_data["Dataset processing"]
  node_projects["Project and dataset management"]
  node_loader["Dataset loading<br/>[loader.py]"]
  node_profiling["Profiling and quality"]
  node_cleaning["Versioned cleaning<br/>[cleaner.py]"]
end

subgraph group_analysis["Analysis and AI"]
  node_analytics["Statistical analytics<br/>[engine.py]"]
  node_visualization["Chart generation<br/>[visualization.py]"]
  node_patterns["Pattern discovery<br/>[detector.py]"]
  node_copilot["AI copilot<br/>[gateway.py]"]
  node_rag["Semantic retrieval<br/>[rag.py]"]
  node_insights["Insight generation"]
  node_reports["Report generation<br/>[generator.py]"]
end

subgraph group_platform["Persistence and security"]
  node_storage["File storage<br/>[storage.py]"]
  node_db[("Relational database<br/>[database.py]")]
  node_embeddings[("Embedding records<br/>[embedding.py]")]
end

node_user(("User"))
node_gemini["Google Gemini"]

node_user -->|"uses"| node_routes
node_routes -->|"routes to"| node_workspace
node_routes -->|"routes to"| node_feature_pages
node_workspace -->|"uses"| node_workspace_state
node_workspace -->|"requests data"| node_api_client
node_workspace_state -->|"loads workspace"| node_api_client
node_api_client -.->|"calls API"| node_api_router
node_api_router -->|"registers routes"| node_endpoints
node_endpoints -.->|"handles management"| node_projects
node_projects -.->|"loads uploaded data"| node_loader
node_loader -.->|"profiles data"| node_profiling
node_profiling -.->|"informs cleaning"| node_cleaning
node_cleaning -.->|"prepares versions"| node_analytics
node_analytics -.->|"feeds charting"| node_visualization
node_analytics -.->|"supports discovery"| node_patterns
node_analytics -.->|"provides evidence"| node_insights
node_insights -.->|"included in reports"| node_reports
node_endpoints -.->|"serves copilot"| node_copilot
node_copilot -.->|"retrieves context"| node_rag
node_copilot -.->|"requests explanations"| node_gemini
node_loader -.->|"stores dataset files"| node_storage
node_rag -->|"uses vectors"| node_embeddings
node_embeddings -.->|"persists records"| node_db
node_api_router -.->|"uses persistence"| node_db

click node_routes "https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/routes/AppRoutes.tsx"
click node_workspace "https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/pages/WorkspacePage.tsx"
click node_feature_pages "https://github.com/siddeshhallale07/aether-ai/tree/main/frontend/src/pages"
click node_workspace_state "https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/stores/useWorkspaceStore.ts"
click node_api_client "https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/services/api.ts"
click node_api_router "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/api/v1/api.py"
click node_endpoints "https://github.com/siddeshhallale07/aether-ai/tree/main/backend/app/api/v1/endpoints"
click node_projects "https://github.com/siddeshhallale07/aether-ai/tree/main/backend/app/api/v1/endpoints"
click node_loader "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/data_processing/loader.py"
click node_profiling "https://github.com/siddeshhallale07/aether-ai/tree/main/backend/app/data_processing"
click node_cleaning "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/data_processing/cleaner.py"
click node_analytics "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/analytics/engine.py"
click node_visualization "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/analytics/visualization.py"
click node_patterns "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/pattern_discovery/detector.py"
click node_copilot "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/ai/gateway.py"
click node_rag "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/ai/rag.py"
click node_insights "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/ai/insights_generator.py"
click node_reports "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/reports/generator.py"
click node_storage "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/services/storage.py"
click node_db "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/core/database.py"
click node_embeddings "https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/models/embedding.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_routes,node_workspace,node_feature_pages,node_workspace_state,node_user toneBlue
class node_api_client,node_api_router,node_endpoints toneAmber
class node_projects,node_loader,node_profiling,node_cleaning toneMint
class node_analytics,node_visualization,node_patterns,node_copilot,node_rag,node_insights,node_reports toneRose
class node_storage,node_db,node_embeddings,node_gemini toneIndigo
```

## Components

### User workspace

- [Application routes](https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/routes/AppRoutes.tsx): `frontend/src/routes/AppRoutes.tsx`
- [Workspace UI](https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/pages/WorkspacePage.tsx): `frontend/src/pages/WorkspacePage.tsx`
- [Feature pages](https://github.com/siddeshhallale07/aether-ai/tree/main/frontend/src/pages): `frontend/src/pages`
- [Workspace state](https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/stores/useWorkspaceStore.ts): `frontend/src/stores/useWorkspaceStore.ts`

### API and services

- [API client](https://github.com/siddeshhallale07/aether-ai/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [API router](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/api/v1/api.py): `backend/app/api/v1/api.py`
- [Feature endpoints](https://github.com/siddeshhallale07/aether-ai/tree/main/backend/app/api/v1/endpoints): `backend/app/api/v1/endpoints`

### Dataset processing

- [Project and dataset management](https://github.com/siddeshhallale07/aether-ai/tree/main/backend/app/api/v1/endpoints): `backend/app/api/v1/endpoints`
- [Dataset loading](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/data_processing/loader.py): `backend/app/data_processing/loader.py`
- [Profiling and quality](https://github.com/siddeshhallale07/aether-ai/tree/main/backend/app/data_processing): `backend/app/data_processing`
- [Versioned cleaning](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/data_processing/cleaner.py): `backend/app/data_processing/cleaner.py`

### Analysis and AI

- [Statistical analytics](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/analytics/engine.py): `backend/app/analytics/engine.py`
- [Chart generation](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/analytics/visualization.py): `backend/app/analytics/visualization.py`
- [Pattern discovery](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/pattern_discovery/detector.py): `backend/app/pattern_discovery/detector.py`
- [AI copilot](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/ai/gateway.py): `backend/app/ai/gateway.py`
- [Semantic retrieval](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/ai/rag.py): `backend/app/ai/rag.py`
- [Insight generation](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/ai/insights_generator.py): `backend/app/ai/insights_generator.py`
- [Report generation](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/reports/generator.py): `backend/app/reports/generator.py`

### Persistence and security

- [File storage](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [Relational database](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Embedding records](https://github.com/siddeshhallale07/aether-ai/blob/main/backend/app/models/embedding.py): `backend/app/models/embedding.py`

### Other components

- **User**
- **Google Gemini**

## Connections

- User → Application routes: uses (evidence: `README.md`)
- Application routes → Workspace UI: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Application routes → Feature pages: routes to (evidence: `frontend/src/routes/AppRoutes.tsx`)
- Workspace UI → Workspace state: uses (evidence: `frontend/src/pages/WorkspacePage.tsx`)
- Workspace UI → API client: requests data (evidence: `frontend/src/pages/WorkspacePage.tsx`)
- Workspace state → API client: loads workspace (evidence: `frontend/src/stores/useWorkspaceStore.ts`)
- API client → API router: calls API (evidence: `README.md`)
- API router → Feature endpoints: registers routes (evidence: `backend/app/api/v1/api.py`)
- Feature endpoints → Project and dataset management: handles management (evidence: `README.md`)
- Project and dataset management → Dataset loading: loads uploaded data (evidence: `README.md`)
- Dataset loading → Profiling and quality: profiles data (evidence: `README.md`)
- Profiling and quality → Versioned cleaning: informs cleaning (evidence: `README.md`)
- Versioned cleaning → Statistical analytics: prepares versions (evidence: `README.md`)
- Statistical analytics → Chart generation: feeds charting (evidence: `README.md`)
- Statistical analytics → Pattern discovery: supports discovery (evidence: `README.md`)
- Statistical analytics → Insight generation: provides evidence (evidence: `README.md`)
- Insight generation → Report generation: included in reports (evidence: `README.md`)
- Feature endpoints → AI copilot: serves copilot (evidence: `README.md`)
- AI copilot → Semantic retrieval: retrieves context (evidence: `README.md`)
- AI copilot → Google Gemini: requests explanations (evidence: `README.md`)
- Dataset loading → File storage: stores dataset files (evidence: `README.md`)
- Semantic retrieval → Embedding records: uses vectors (evidence: `backend/app/ai/rag.py`)
- Embedding records → Relational database: persists records (evidence: `backend/app/models/embedding.py`)
- API router → Relational database: uses persistence (evidence: `README.md`)
