# aishwaryanr/awesome-generative-ai-guide architecture

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

- Interactive diagram: https://gitdiagram.com/aishwaryanr/awesome-generative-ai-guide
- Repository: https://github.com/aishwaryanr/awesome-generative-ai-guide

## Overview

This repository is a curated generative-AI learning hub, not one runtime application. Its user workflow is to choose a learning goal, follow a journey or topic, and open courses, interview materials, research, videos, or runnable examples. The sampled code includes multiple independent system-design examples and a local company-agent harness; they are learning artifacts, not one connected service. Edges reflect README navigation or explicit source references. Unsampled implementation details are not inferred.

Main entry points: [`interview_prep/system-design`](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/interview_prep/system-design) (System design cases), [`README.md`](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/README.md) (AI guide hub), [`youtube/code/ns-work-harness/server.py`](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/server.py) (Application server), [`youtube/code/ns-work-harness/company.py`](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/company.py) (Company data service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Learning guide"]
  node_hub["AI guide hub<br/>[README.md]"]
  node_journeys["Learning journeys"]
  node_topics["Topic guides"]
end

subgraph group_learning["Learning resources"]
  node_courses["Course catalog<br/>[courses.md]"]
  node_free_courses["Free courses"]
  node_tools["AI tools list"]
  node_research["Research updates"]
  node_report["State of AI report"]
  node_video["Video resources<br/>[README.md]"]
end

subgraph group_interview["Interview examples"]
  node_interview_hub["Interview prep hub<br/>[README.md]"]
  node_case_studies["System design cases"]
  node_decisioning["Decisioning examples"]
  node_financial_decision["Financial decisions<br/>[decision_agent.py]"]
  node_sdr["Sales qualification<br/>[sdr_agent.py]"]
  node_sql["SQL analytics<br/>[sql_agent.py]"]
  node_sql_model["SQL model jobs<br/>[llm.py]"]
  node_sql_db[("Analytics database<br/>[db.py]")]
  node_coding_agent["Coding agent<br/>[agent.py]"]
  node_coding_model["Edit proposals<br/>[llm.py]"]
  node_sandbox["Code sandbox<br/>[sandbox.py]"]
  node_scribe["Clinical scribe<br/>[scribe.py]"]
  node_voice_kb["Voice support KB<br/>[kb.py]"]
  node_research_agent["Research assistant<br/>[research_agent.py]"]
  node_support_agent["Customer support<br/>[support_agent.py]"]
  node_security_agent["Security compliance"]
end

subgraph group_harness["Company harness"]
  node_harness_guide["Harness guide"]
  node_web_ui["Local interface<br/>[app.js]"]
  node_server["Application server<br/>[server.py]"]
  node_stages["Agent stages<br/>[stages.py]"]
  node_company["Company data service<br/>[company.py]"]
  node_binding["Tool authorization<br/>[binding.py]"]
  node_workspace["Workspace files<br/>[workspace.py]"]
  node_proposal_tool["Proposal outbox<br/>[proposals.py]"]
end

node_reader(("Learner"))

node_reader -->|"opens"| node_hub
node_hub -->|"offers"| node_journeys
node_hub -->|"links"| node_topics
node_hub -->|"links"| node_courses
node_hub -->|"features"| node_free_courses
node_hub -->|"links"| node_tools
node_hub -->|"links"| node_research
node_hub -->|"links"| node_interview_hub
node_hub -->|"links"| node_video
node_research -->|"includes"| node_report
node_interview_hub -->|"links"| node_case_studies
node_case_studies -.->|"includes"| node_decisioning
node_case_studies -.->|"includes"| node_financial_decision
node_case_studies -.->|"includes"| node_sdr
node_case_studies -.->|"includes"| node_sql
node_sql -->|"uses"| node_sql_model
node_sql -->|"queries"| node_sql_db
node_case_studies -.->|"includes"| node_coding_agent
node_coding_agent -->|"requests edits"| node_coding_model
node_coding_agent -->|"runs code"| node_sandbox
node_case_studies -.->|"includes"| node_scribe
node_case_studies -.->|"includes"| node_voice_kb
node_case_studies -.->|"includes"| node_research_agent
node_case_studies -.->|"includes"| node_support_agent
node_case_studies -.->|"includes"| node_security_agent
node_video -->|"features"| node_harness_guide
node_harness_guide -.->|"introduces"| node_web_ui
node_web_ui -.->|"uses"| node_server
node_server -->|"builds"| node_stages
node_server -->|"configures"| node_company
node_server -->|"recovers files"| node_workspace
node_stages -->|"binds tools"| node_company
node_company -->|"binds access"| node_binding
node_binding -->|"wraps tools"| node_proposal_tool
node_company -->|"provides data"| node_proposal_tool

click node_hub "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/README.md"
click node_journeys "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/journeys"
click node_topics "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/topics"
click node_courses "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/courses.md"
click node_free_courses "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/free_courses"
click node_tools "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/resources/our_favourite_ai_tools.md"
click node_research "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/research_updates"
click node_report "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/research_updates/state_of_ai_2025_report"
click node_interview_hub "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/README.md"
click node_case_studies "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/interview_prep/system-design"
click node_decisioning "https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/interview_prep/system-design/document-decisioning/code"
click node_financial_decision "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/financial-ops-decisioning/code/decision_agent.py"
click node_sdr "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/sdr-sales-agent/code/sdr_agent.py"
click node_sql "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/text-to-sql-analytics/code/sql_agent.py"
click node_sql_model "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/text-to-sql-analytics/code/llm.py"
click node_sql_db "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/text-to-sql-analytics/code/db.py"
click node_coding_agent "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/coding-agent/code/agent.py"
click node_coding_model "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/coding-agent/code/llm.py"
click node_sandbox "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/coding-agent/code/sandbox.py"
click node_scribe "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/clinical-scribe/code/scribe.py"
click node_voice_kb "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/voice-support-agent/code/kb.py"
click node_research_agent "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/enterprise-research-assistant/code/research_agent.py"
click node_support_agent "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/customer-support-agent/code/support_agent.py"
click node_security_agent "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/security-compliance-agent/code/compliance_agent.py"
click node_video "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/README.md"
click node_harness_guide "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/build-your-own-harness.md"
click node_web_ui "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/web/app.js"
click node_server "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/server.py"
click node_stages "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/stages.py"
click node_company "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/company.py"
click node_binding "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/tools/binding.py"
click node_workspace "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/workspace.py"
click node_proposal_tool "https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/tools/proposals.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_hub,node_journeys,node_topics toneBlue
class node_courses,node_free_courses,node_tools,node_research,node_report,node_video toneAmber
class node_interview_hub,node_case_studies,node_decisioning,node_financial_decision,node_sdr,node_sql,node_sql_model,node_sql_db,node_coding_agent,node_coding_model,node_sandbox,node_scribe,node_voice_kb,node_research_agent,node_support_agent,node_security_agent toneMint
class node_harness_guide,node_web_ui,node_server,node_stages,node_company,node_binding,node_workspace,node_proposal_tool toneRose
class node_reader toneIndigo
```

## Components

### Learning guide

- [AI guide hub](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/README.md): `README.md`
- [Learning journeys](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/journeys): `journeys`
- [Topic guides](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/topics): `topics`

### Learning resources

- [Course catalog](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/courses.md): `courses.md`
- [Free courses](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/free_courses): `free_courses`
- [AI tools list](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/resources/our_favourite_ai_tools.md): `resources/our_favourite_ai_tools.md`
- [Research updates](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/research_updates): `research_updates`
- [State of AI report](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/research_updates/state_of_ai_2025_report): `research_updates/state_of_ai_2025_report`
- [Video resources](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/README.md): `youtube/README.md`

### Interview examples

- [Interview prep hub](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/README.md): `interview_prep/README.md`
- [System design cases](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/interview_prep/system-design): `interview_prep/system-design`
- [Decisioning examples](https://github.com/aishwaryanr/awesome-generative-ai-guide/tree/main/interview_prep/system-design/document-decisioning/code): `interview_prep/system-design/document-decisioning/code`
- [Financial decisions](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/financial-ops-decisioning/code/decision_agent.py): `interview_prep/system-design/financial-ops-decisioning/code/decision_agent.py`
- [Sales qualification](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/sdr-sales-agent/code/sdr_agent.py): `interview_prep/system-design/sdr-sales-agent/code/sdr_agent.py`
- [SQL analytics](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/text-to-sql-analytics/code/sql_agent.py): `interview_prep/system-design/text-to-sql-analytics/code/sql_agent.py`
- [SQL model jobs](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/text-to-sql-analytics/code/llm.py): `interview_prep/system-design/text-to-sql-analytics/code/llm.py`
- [Analytics database](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/text-to-sql-analytics/code/db.py): `interview_prep/system-design/text-to-sql-analytics/code/db.py`
- [Coding agent](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/coding-agent/code/agent.py): `interview_prep/system-design/coding-agent/code/agent.py`
- [Edit proposals](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/coding-agent/code/llm.py): `interview_prep/system-design/coding-agent/code/llm.py`
- [Code sandbox](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/coding-agent/code/sandbox.py): `interview_prep/system-design/coding-agent/code/sandbox.py`
- [Clinical scribe](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/clinical-scribe/code/scribe.py): `interview_prep/system-design/clinical-scribe/code/scribe.py`
- [Voice support KB](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/voice-support-agent/code/kb.py): `interview_prep/system-design/voice-support-agent/code/kb.py`
- [Research assistant](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/enterprise-research-assistant/code/research_agent.py): `interview_prep/system-design/enterprise-research-assistant/code/research_agent.py`
- [Customer support](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/customer-support-agent/code/support_agent.py): `interview_prep/system-design/customer-support-agent/code/support_agent.py`
- [Security compliance](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/interview_prep/system-design/security-compliance-agent/code/compliance_agent.py): `interview_prep/system-design/security-compliance-agent/code/compliance_agent.py`

### Company harness

- [Harness guide](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/build-your-own-harness.md): `youtube/build-your-own-harness.md`
- [Local interface](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/web/app.js): `youtube/code/ns-work-harness/web/app.js`
- [Application server](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/server.py): `youtube/code/ns-work-harness/server.py`
- [Agent stages](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/stages.py): `youtube/code/ns-work-harness/stages.py`
- [Company data service](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/company.py): `youtube/code/ns-work-harness/company.py`
- [Tool authorization](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/tools/binding.py): `youtube/code/ns-work-harness/tools/binding.py`
- [Workspace files](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/workspace.py): `youtube/code/ns-work-harness/workspace.py`
- [Proposal outbox](https://github.com/aishwaryanr/awesome-generative-ai-guide/blob/main/youtube/code/ns-work-harness/tools/proposals.py): `youtube/code/ns-work-harness/tools/proposals.py`

### Other components

- **Learner**

## Connections

- Learner → AI guide hub: opens (evidence: `README.md`)
- AI guide hub → Learning journeys: offers (evidence: `README.md`)
- AI guide hub → Topic guides: links (evidence: `README.md`)
- AI guide hub → Course catalog: links (evidence: `README.md`)
- AI guide hub → Free courses: features (evidence: `README.md`)
- AI guide hub → AI tools list: links (evidence: `README.md`)
- AI guide hub → Research updates: links (evidence: `README.md`)
- AI guide hub → Interview prep hub: links (evidence: `README.md`)
- AI guide hub → Video resources: links (evidence: `README.md`)
- Research updates → State of AI report: includes (evidence: `README.md`)
- Interview prep hub → System design cases: links (evidence: `README.md`)
- System design cases → Decisioning examples: includes (evidence: `interview_prep/system-design/security-compliance-agent/code/llm.py`)
- System design cases → Financial decisions: includes (evidence: `interview_prep/system-design/financial-ops-decisioning/code/run.py`)
- System design cases → Sales qualification: includes (evidence: `interview_prep/system-design/sdr-sales-agent/code/sdr_agent.py`)
- System design cases → SQL analytics: includes (evidence: `interview_prep/system-design/text-to-sql-analytics/code/sql_agent.py`)
- SQL analytics → SQL model jobs: uses (evidence: `interview_prep/system-design/text-to-sql-analytics/code/sql_agent.py`)
- SQL analytics → Analytics database: queries (evidence: `interview_prep/system-design/text-to-sql-analytics/code/sql_agent.py`)
- System design cases → Coding agent: includes (evidence: `interview_prep/system-design/coding-agent/code/agent.py`)
- Coding agent → Edit proposals: requests edits (evidence: `interview_prep/system-design/coding-agent/code/agent.py`)
- Coding agent → Code sandbox: runs code (evidence: `interview_prep/system-design/coding-agent/code/agent.py`)
- System design cases → Clinical scribe: includes (evidence: `interview_prep/system-design/clinical-scribe/code/run.py`)
- System design cases → Voice support KB: includes (evidence: `interview_prep/system-design/enterprise-research-assistant/code/research_agent.py`)
- System design cases → Research assistant: includes (evidence: `interview_prep/system-design/enterprise-research-assistant/code/research_agent.py`)
- System design cases → Customer support: includes (evidence: `interview_prep/system-design/customer-support-agent/code/support_agent.py`)
- System design cases → Security compliance: includes
- Video resources → Harness guide: features (evidence: `README.md`)
- Harness guide → Local interface: introduces
- Local interface → Application server: uses
- Application server → Agent stages: builds (evidence: `youtube/code/ns-work-harness/server.py`)
- Application server → Company data service: configures (evidence: `youtube/code/ns-work-harness/server.py`)
- Application server → Workspace files: recovers files (evidence: `youtube/code/ns-work-harness/server.py`)
- Agent stages → Company data service: binds tools (evidence: `youtube/code/ns-work-harness/stages.py`)
- Company data service → Tool authorization: binds access (evidence: `youtube/code/ns-work-harness/company.py`)
- Tool authorization → Proposal outbox: wraps tools (evidence: `youtube/code/ns-work-harness/tools/binding.py`)
- Company data service → Proposal outbox: provides data (evidence: `youtube/code/ns-work-harness/tools/proposals.py`)
