# adnan-15/fluent_ai architecture

> Architecture diagram of the GitHub repository adnan-15/fluent_ai, 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/adnan-15/fluent_ai
- Repository: https://github.com/adnan-15/fluent_ai

## Overview

Fluent AI is a Django English-learning application. Learners use its routed web interface for lessons and quizzes, question-based and interview practice, proficiency assessment, progress tracking, video notes, and an AI Tutor; the browser also supplies speech input/output for tutoring, as documented in the README. The sampled routes dispatch to learning views, which use the learning models and call the AI service. The source index confirms these imports, but excerpts do not show every feature’s internal calls, so the graph keeps those stages within the views component rather than guessing at finer-grained relationships.

Main entry points: [`fluent_ai/learning/views.py`](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py) (Learning views), [`fluent_ai/learning/urls.py`](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/urls.py) (Learning routes), [`fluent_ai/learning/ai_service.py`](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/ai_service.py) (AI response service), [`fluent_ai/learning/models.py`](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/models.py) (Learning records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_routes["Learning routes<br/>[urls.py]"]
  node_learning_views["Learning views<br/>[views.py]"]
  node_templates["Web templates"]
  node_fluent_ai_settings["Django settings<br/>[settings.py]"]
end

subgraph group_learning["Learning features"]
  node_lessons["Lessons and quizzes<br/>[views.py]"]
  node_practice["Practice hub<br/>[views.py]"]
  node_interviews["Interview practice<br/>[views.py]"]
  node_assessment["Proficiency assessment<br/>[views.py]"]
  node_progress["Progress and profile<br/>[views.py]"]
  node_video_notes["Video notes<br/>[views.py]"]
  node_practice_seed["Practice question bank"]
end

subgraph group_data["Persistence"]
  node_learning_models["Learning records<br/>[models.py]"]
  node_sqlite[("SQLite database<br/>[db.sqlite3]")]
end

subgraph group_ai["AI Tutor"]
  node_ai_service["AI response service<br/>[ai_service.py]"]
  node_ollama{{"Ollama API"}}
end

node_learner(("Learner"))

node_learner -->|"requests pages"| node_routes
node_routes -->|"dispatches routes"| node_learning_views
node_learning_views -.->|"serves learning"| node_lessons
node_learning_views -.->|"serves practice"| node_practice
node_learning_views -.->|"serves interviews"| node_interviews
node_learning_views -.->|"serves assessments"| node_assessment
node_learning_views -.->|"serves progress"| node_progress
node_learning_views -.->|"serves notes"| node_video_notes
node_learning_views -->|"uses records"| node_learning_models
node_practice_seed -->|"creates questions"| node_learning_models
node_learning_views -->|"requests responses"| node_ai_service
node_ai_service -.->|"sends prompts"| node_ollama
node_fluent_ai_settings -->|"configures database"| node_sqlite

click node_routes "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/urls.py"
click node_learning_views "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_templates "https://github.com/adnan-15/fluent_ai/tree/main/fluent_ai/learning/templates"
click node_lessons "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_practice "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_interviews "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_assessment "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_progress "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_video_notes "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py"
click node_practice_seed "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/management/commands/seed_practicehub.py"
click node_learning_models "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/models.py"
click node_sqlite "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/db.sqlite3"
click node_ai_service "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/ai_service.py"
click node_fluent_ai_settings "https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/fluent_ai/settings.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_learning_views,node_templates,node_fluent_ai_settings toneBlue
class node_lessons,node_practice,node_interviews,node_assessment,node_progress,node_video_notes,node_practice_seed toneAmber
class node_learning_models,node_sqlite toneMint
class node_ai_service,node_ollama toneRose
class node_learner toneIndigo
```

## Components

### Web application

- [Learning routes](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/urls.py): `fluent_ai/learning/urls.py`
- [Learning views](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Web templates](https://github.com/adnan-15/fluent_ai/tree/main/fluent_ai/learning/templates): `fluent_ai/learning/templates`
- [Django settings](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/fluent_ai/settings.py): `fluent_ai/fluent_ai/settings.py`

### Learning features

- [Lessons and quizzes](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Practice hub](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Interview practice](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Proficiency assessment](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Progress and profile](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Video notes](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/views.py): `fluent_ai/learning/views.py`
- [Practice question bank](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/management/commands/seed_practicehub.py): `fluent_ai/learning/management/commands/seed_practicehub.py`

### Persistence

- [Learning records](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/models.py): `fluent_ai/learning/models.py`
- [SQLite database](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/db.sqlite3): `fluent_ai/db.sqlite3`

### AI Tutor

- [AI response service](https://github.com/adnan-15/fluent_ai/blob/main/fluent_ai/learning/ai_service.py): `fluent_ai/learning/ai_service.py`
- **Ollama API**

### Other components

- **Learner**

## Connections

- Learner → Learning routes: requests pages (evidence: `fluent_ai/learning/urls.py`)
- Learning routes → Learning views: dispatches routes (evidence: `fluent_ai/learning/urls.py`)
- Learning views → Lessons and quizzes: serves learning (evidence: `fluent_ai/learning/views.py`)
- Learning views → Practice hub: serves practice (evidence: `fluent_ai/learning/views.py`)
- Learning views → Interview practice: serves interviews (evidence: `fluent_ai/learning/views.py`)
- Learning views → Proficiency assessment: serves assessments (evidence: `fluent_ai/learning/views.py`)
- Learning views → Progress and profile: serves progress (evidence: `fluent_ai/learning/views.py`)
- Learning views → Video notes: serves notes (evidence: `fluent_ai/learning/views.py`)
- Learning views → Learning records: uses records (evidence: `fluent_ai/learning/views.py`)
- Practice question bank → Learning records: creates questions (evidence: `fluent_ai/learning/management/commands/seed_practicehub.py`)
- Learning views → AI response service: requests responses (evidence: `fluent_ai/learning/views.py`)
- AI response service → Ollama API: sends prompts
- Django settings → SQLite database: configures database (evidence: `fluent_ai/fluent_ai/settings.py`)
