# learncodingeasy/so_iam_os architecture

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

- Interactive diagram: https://gitdiagram.com/learncodingeasy/so_iam_os
- Repository: https://github.com/learncodingeasy/so_iam_os

## Overview

So_Iam_OS is a Vue/Django personal AI operating system for turning personal context, learning, projects, and goals into actions and measurable outcomes. Its intended loop is user → AI assistance and memory → planning/execution → results and learning; the repository also contains distinct career, finance, knowledge, and automation capabilities. The sampled sources establish selected AI, learning, knowledge, scraping, and finance behavior; many other links are documented at product level or remain unverified, so they are shown as dashed where appropriate.

Main entry points: [`backend_django/ai/services.py`](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/services.py) (AI conversation service), [`backend_django/learning/models.py`](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/learning/models.py) (Learning paths and assessment), [`backend_django/jobs_opportunity/services.py`](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/jobs_opportunity/services.py) (Job opportunities), [`backend_django/knowledge/services.py`](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/knowledge/services.py) (Knowledge and files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_webapp["Vue application<br/>[App.vue]"]
end

subgraph group_intelligence["AI and context"]
  node_ai_api["AI API<br/>[views.py]"]
  node_ai_service["AI conversation service<br/>[services.py]"]
  node_ai_provider["AI providers<br/>[providers.py]"]
  node_ai_state[("AI conversations and settings<br/>[models.py]")]
  node_memory[("Personal memory<br/>[models.py]")]
  node_knowledge["Knowledge and files<br/>[services.py]"]
end

subgraph group_growth["Learning and goals"]
  node_learning[("Learning paths and assessment<br/>[models.py]")]
  node_goals["Goals and progress<br/>[services.py]"]
  node_tasks[("Tasks<br/>[models.py]")]
end

subgraph group_work["Work and opportunities"]
  node_projects[("Projects<br/>[models.py]")]
  node_jobs["Job opportunities<br/>[services.py]"]
  node_finance["Personal finance<br/>[services.py]"]
  node_scraper["External source scraping<br/>[services.py]"]
  node_codex["Codex workspace<br/>[execution.py]"]
end

subgraph group_execution["Automation and services"]
  node_automation["Automation engine<br/>[engine_runtime.py]"]
  node_automation_programs["Automation programs<br/>[program_service.py]"]
  node_notifications[("Notifications<br/>[models.py]")]
end

node_user(("Personal user"))

node_user -.->|"uses"| node_webapp
node_webapp -.->|"requests AI"| node_ai_api
node_ai_api -.->|"dispatches"| node_ai_service
node_ai_service -->|"stores conversations"| node_ai_state
node_ai_service -->|"calls provider"| node_ai_provider
node_ai_service -.->|"builds context"| node_memory
node_ai_service -.->|"uses context"| node_knowledge
node_ai_service -.->|"uses context"| node_goals
node_ai_service -.->|"uses context"| node_tasks
node_ai_service -.->|"uses context"| node_learning
node_ai_service -.->|"uses context"| node_jobs
node_ai_service -.->|"uses context"| node_projects
node_user -.->|"learns"| node_learning
node_learning -.->|"supports goals"| node_goals
node_goals -.->|"tracks progress"| node_tasks
node_user -.->|"adds knowledge"| node_knowledge
node_knowledge -->|"connects topics"| node_learning
node_user -.->|"builds projects"| node_projects
node_user -.->|"tracks opportunities"| node_jobs
node_jobs -->|"creates learning goals"| node_learning
node_scraper -.->|"normalizes sources"| node_jobs
node_user -.->|"manages finances"| node_finance
node_user -.->|"uses workspace"| node_codex
node_user -.->|"configures actions"| node_automation_programs
node_automation_programs -.->|"executes actions"| node_automation
node_automation -.->|"acts on device"| node_user
node_user -.->|"receives updates"| node_notifications

click node_webapp "https://github.com/learncodingeasy/so_iam_os/blob/main/frontend_vue/src/App.vue"
click node_ai_api "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/views.py"
click node_ai_service "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/services.py"
click node_ai_provider "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/services/providers.py"
click node_ai_state "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/models.py"
click node_memory "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/memory/models.py"
click node_knowledge "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/knowledge/services.py"
click node_learning "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/learning/models.py"
click node_goals "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/goals/services.py"
click node_tasks "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/tasks/models.py"
click node_projects "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/projects/models.py"
click node_jobs "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/jobs_opportunity/services.py"
click node_finance "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/personal_finance/services.py"
click node_scraper "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/scraper/services.py"
click node_codex "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/codex/services/execution.py"
click node_automation "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/automation/engine_runtime.py"
click node_automation_programs "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/automation/services/program_service.py"
click node_notifications "https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/notification/models.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_webapp,node_user toneBlue
class node_ai_api,node_ai_service,node_ai_provider,node_ai_state,node_memory,node_knowledge toneAmber
class node_learning,node_goals,node_tasks toneMint
class node_projects,node_jobs,node_finance,node_scraper,node_codex toneRose
class node_automation,node_automation_programs,node_notifications toneIndigo
```

## Components

### User experience

- [Vue application](https://github.com/learncodingeasy/so_iam_os/blob/main/frontend_vue/src/App.vue): `frontend_vue/src/App.vue`

### AI and context

- [AI API](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/views.py): `backend_django/ai/views.py`
- [AI conversation service](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/services.py): `backend_django/ai/services.py`
- [AI providers](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/services/providers.py): `backend_django/ai/services/providers.py`
- [AI conversations and settings](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/ai/models.py): `backend_django/ai/models.py`
- [Personal memory](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/memory/models.py): `backend_django/memory/models.py`
- [Knowledge and files](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/knowledge/services.py): `backend_django/knowledge/services.py`

### Learning and goals

- [Learning paths and assessment](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/learning/models.py): `backend_django/learning/models.py`
- [Goals and progress](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/goals/services.py): `backend_django/goals/services.py`
- [Tasks](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/tasks/models.py): `backend_django/tasks/models.py`

### Work and opportunities

- [Projects](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/projects/models.py): `backend_django/projects/models.py`
- [Job opportunities](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/jobs_opportunity/services.py): `backend_django/jobs_opportunity/services.py`
- [Personal finance](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/personal_finance/services.py): `backend_django/personal_finance/services.py`
- [External source scraping](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/scraper/services.py): `backend_django/scraper/services.py`
- [Codex workspace](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/codex/services/execution.py): `backend_django/codex/services/execution.py`

### Automation and services

- [Automation engine](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/automation/engine_runtime.py): `backend_django/automation/engine_runtime.py`
- [Automation programs](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/automation/services/program_service.py): `backend_django/automation/services/program_service.py`
- [Notifications](https://github.com/learncodingeasy/so_iam_os/blob/main/backend_django/notification/models.py): `backend_django/notification/models.py`

### Other components

- **Personal user**

## Connections

- Personal user → Vue application: uses (evidence: `README.md`)
- Vue application → AI API: requests AI
- AI API → AI conversation service: dispatches
- AI conversation service → AI conversations and settings: stores conversations (evidence: `backend_django/ai/services.py`)
- AI conversation service → AI providers: calls provider (evidence: `backend_django/ai/services.py`)
- AI conversation service → Personal memory: builds context (evidence: `backend_django/ai/services.py`)
- AI conversation service → Knowledge and files: uses context (evidence: `backend_django/ai/services.py`)
- AI conversation service → Goals and progress: uses context (evidence: `backend_django/ai/services.py`)
- AI conversation service → Tasks: uses context (evidence: `backend_django/ai/services.py`)
- AI conversation service → Learning paths and assessment: uses context (evidence: `backend_django/ai/services.py`)
- AI conversation service → Job opportunities: uses context (evidence: `backend_django/ai/services.py`)
- AI conversation service → Projects: uses context (evidence: `backend_django/ai/services.py`)
- Personal user → Learning paths and assessment: learns (evidence: `README.md`)
- Learning paths and assessment → Goals and progress: supports goals (evidence: `README.md`)
- Goals and progress → Tasks: tracks progress (evidence: `backend_django/tasks/services.py`)
- Personal user → Knowledge and files: adds knowledge (evidence: `README.md`)
- Knowledge and files → Learning paths and assessment: connects topics (evidence: `backend_django/knowledge/services.py`)
- Personal user → Projects: builds projects (evidence: `README.md`)
- Personal user → Job opportunities: tracks opportunities (evidence: `README.md`)
- Job opportunities → Learning paths and assessment: creates learning goals (evidence: `backend_django/jobs_opportunity/services.py`)
- External source scraping → Job opportunities: normalizes sources (evidence: `backend_django/scraper/services.py`)
- Personal user → Personal finance: manages finances (evidence: `README.md`)
- Personal user → Codex workspace: uses workspace (evidence: `README.md`)
- Personal user → Automation programs: configures actions (evidence: `README.md`)
- Automation programs → Automation engine: executes actions
- Automation engine → Personal user: acts on device (evidence: `backend_django/automation/engine_runtime.py`)
- Personal user → Notifications: receives updates (evidence: `README.md`)
