# mortem1504/ai-guitar-tuto-integration-public architecture

> Architecture diagram of the GitHub repository mortem1504/ai-guitar-tuto-integration-public, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mortem1504/ai-guitar-tuto-integration-public
- Repository: https://github.com/mortem1504/ai-guitar-tuto-integration-public

## Overview

AI Guitar Coach currently implements a basic offline audio workflow: a guitarist records a note, the recording is saved, and an analysis script detects its pitch, converts it to a musical note, and prints the result. The README describes computer vision and real-time coaching as future capabilities, not implemented runtime stages; they are shown as planned branches. The sampled source supports the audio call and file-flow edges; planned connections are omitted rather than inferred.

Main entry points: [`src/audio/analyze_recording.py`](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/analyze_recording.py) (Recording analysis), [`src/audio/record_audio.py`](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/record_audio.py) (Audio recorder), [`data`](https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/data) (Audio recording), [`src/audio/pitch_detector.py`](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/pitch_detector.py) (Pitch detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audio["Audio workflow"]
  node_recorder["Audio recorder<br/>[record_audio.py]"]
  node_recording["Audio recording"]
  node_analyzer["Recording analysis"]
  node_pitch["Pitch detection<br/>[pitch_detector.py]"]
  node_note["Note conversion<br/>[pitch_detector.py]"]
end

subgraph group_planned["Planned coaching"]
  node_vision["Guitar vision"]
  node_coaching["Coaching feedback"]
end

node_guitarist(("Guitarist"))

node_guitarist -->|"plays for"| node_recorder
node_recorder -->|"writes"| node_recording
node_recording -->|"loads"| node_analyzer
node_analyzer -->|"detects pitch"| node_pitch
node_analyzer -->|"converts frequency"| node_note

click node_recorder "https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/record_audio.py"
click node_recording "https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/data"
click node_analyzer "https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/analyze_recording.py"
click node_pitch "https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/pitch_detector.py"
click node_note "https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/pitch_detector.py"
click node_vision "https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/src"
click node_coaching "https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/src"

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_recorder,node_recording,node_analyzer,node_pitch,node_note toneBlue
class node_vision,node_coaching toneAmber
class node_guitarist toneIndigo
```

## Components

### Audio workflow

- [Audio recorder](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/record_audio.py): `src/audio/record_audio.py`
- [Audio recording](https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/data): `data`
- [Recording analysis](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/analyze_recording.py): `src/audio/analyze_recording.py`
- [Pitch detection](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/pitch_detector.py): `src/audio/pitch_detector.py`
- [Note conversion](https://github.com/mortem1504/ai-guitar-tuto-integration-public/blob/main/src/audio/pitch_detector.py): `src/audio/pitch_detector.py`

### Planned coaching

- [Guitar vision](https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/src): `src`
- [Coaching feedback](https://github.com/mortem1504/ai-guitar-tuto-integration-public/tree/main/src): `src`

### Other components

- **Guitarist**

## Connections

- Guitarist → Audio recorder: plays for (evidence: `README.md`)
- Audio recorder → Audio recording: writes (evidence: `src/audio/record_audio.py`)
- Audio recording → Recording analysis: loads (evidence: `src/audio/analyze_recording.py`)
- Recording analysis → Pitch detection: detects pitch (evidence: `src/audio/analyze_recording.py`)
- Recording analysis → Note conversion: converts frequency (evidence: `src/audio/analyze_recording.py`)
