# saadahmadofficial1/marketing-house architecture

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

- Interactive diagram: https://gitdiagram.com/saadahmadofficial1/marketing-house
- Repository: https://github.com/saadahmadofficial1/marketing-house

## Overview

This repository is a personal AI-assisted media-production toolkit: standalone tools and local services support training-video, CapCut, photo, voice, and knowledge-work workflows. The best-documented end-to-end path turns screen recordings into an editable, narrated, captioned, marked-up training cut that a person reviews. The graph also preserves the README’s other major product areas. Some links are documented in the README; unsampled tool internals and integrations are not inferred.

Main entry points: [`tools/sa_assemble.py`](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_assemble.py) (CapCut assembly), [`tools/sa_plan_preview.py`](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_plan_preview.py) (Plan preview), [`tools/sa_timeline.py`](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_timeline.py) (Timeline model), [`tools/sa_appread.py`](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_appread.py) (Screen intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_training["Training video"]
  node_screen_read["Screen intake<br/>[sa_appread.py]"]
  node_screen_build["Phone training build<br/>[sa_appbuild.py]"]
  node_markings["Step call-outs<br/>[sa_stepmark.py]"]
  node_voice_anchor["Voice anchors"]
  node_captions["Script captions<br/>[sa_captions.py]"]
  node_privacy["Privacy sweep"]
  node_sync_check["Sync check<br/>[sa_check_sync.py]"]
  node_final_check["Final review<br/>[sa_finalcheck.py]"]
end

subgraph group_editing["Editing and CapCut"]
  node_capcut_assemble["CapCut assembly<br/>[sa_assemble.py]"]
  node_capcut_split["Split-mark editing"]
  node_timeline["Timeline model<br/>[sa_timeline.py]"]
  node_preview["Plan preview<br/>[sa_plan_preview.py]"]
  node_coverage["Marking coverage<br/>[sa_coverage.py]"]
  node_style_data["Editing style data<br/>[sa_learn.py]"]
end

subgraph group_media["Voice and motion"]
  node_photo["Photo workflows<br/>[media_kit.py]"]
  node_voice_kit["Voice cloning kit<br/>[fish_voice.py]"]
  node_motion_template["Slide narration<br/>[SlideNarration.tsx]"]
end

subgraph group_workspace["AI workspace"]
  node_brain_server["Knowledge server<br/>[server.py]"]
  node_rag[("Local retrieval<br/>[rag.py]")]
end

subgraph group_services["Local services"]
  node_studio["Studio MCP<br/>[server.py]"]
  node_cull["Photo cull driver<br/>[cull_driver.py]"]
end

node_producer(("Producer"))
node_capcut_editor(("CapCut editor"))
node_reviewer(("Human reviewer"))

node_producer -->|"reads recording"| node_screen_read
node_screen_read -->|"feeds OCR"| node_screen_build
node_screen_build -->|"renders call-outs"| node_markings
node_producer -->|"anchors voice"| node_voice_anchor
node_producer -->|"makes captions"| node_captions
node_producer -->|"checks privacy"| node_privacy
node_producer -->|"checks sync"| node_sync_check
node_producer -->|"audits cut"| node_final_check
node_producer -->|"builds timeline"| node_capcut_assemble
node_producer -->|"edits markings"| node_capcut_split
node_producer -->|"plans timeline"| node_timeline
node_timeline -->|"validates plan"| node_capcut_assemble
node_producer -->|"previews plan"| node_preview
node_preview -->|"validates plan"| node_timeline
node_preview -->|"uses renderer"| node_capcut_assemble
node_producer -->|"checks coverage"| node_coverage
node_coverage -.->|"reads draft marks"| node_capcut_split
node_producer -->|"learns edit style"| node_style_data
node_producer -->|"works on photos"| node_photo
node_producer -->|"creates voice-over"| node_voice_kit
node_producer -->|"renders narration"| node_motion_template
node_producer -->|"queries knowledge"| node_brain_server
node_brain_server -->|"searches chunks"| node_rag
node_producer -->|"uses local tools"| node_studio
node_studio -.->|"runs cull"| node_cull
node_capcut_assemble -->|"writes draft"| node_capcut_editor
node_capcut_editor -->|"presents cut"| node_reviewer
node_reviewer -->|"reviews render"| node_final_check

click node_screen_read "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_appread.py"
click node_screen_build "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_appbuild.py"
click node_markings "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_stepmark.py"
click node_voice_anchor "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_voice_anchors.py"
click node_captions "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_captions.py"
click node_privacy "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_privacy_sweep.py"
click node_sync_check "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_check_sync.py"
click node_final_check "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_finalcheck.py"
click node_capcut_assemble "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_assemble.py"
click node_capcut_split "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_capcut_split_marks.py"
click node_timeline "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_timeline.py"
click node_preview "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_plan_preview.py"
click node_coverage "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_coverage.py"
click node_style_data "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_learn.py"
click node_photo "https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/media_kit.py"
click node_voice_kit "https://github.com/saadahmadofficial1/marketing-house/blob/main/kits/fish-voice-kit/fish_voice.py"
click node_motion_template "https://github.com/saadahmadofficial1/marketing-house/blob/main/playbooks/templates/remotion/SlideNarration.tsx"
click node_brain_server "https://github.com/saadahmadofficial1/marketing-house/blob/main/workspace-kit/brain/server.py"
click node_rag "https://github.com/saadahmadofficial1/marketing-house/blob/main/workspace-kit/brain/rag.py"
click node_studio "https://github.com/saadahmadofficial1/marketing-house/blob/main/mcp/studio/server.py"
click node_cull "https://github.com/saadahmadofficial1/marketing-house/blob/main/mcp/studio/cull_driver.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_screen_read,node_screen_build,node_markings,node_voice_anchor,node_captions,node_privacy,node_sync_check,node_final_check,node_reviewer toneBlue
class node_capcut_assemble,node_capcut_split,node_timeline,node_preview,node_coverage,node_style_data toneAmber
class node_photo,node_voice_kit,node_motion_template toneMint
class node_brain_server,node_rag toneRose
class node_studio,node_cull,node_producer,node_capcut_editor toneIndigo
```

## Components

### Training video

- [Screen intake](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_appread.py): `tools/sa_appread.py`
- [Phone training build](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_appbuild.py): `tools/sa_appbuild.py`
- [Step call-outs](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_stepmark.py): `tools/sa_stepmark.py`
- [Voice anchors](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_voice_anchors.py): `tools/sa_voice_anchors.py`
- [Script captions](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_captions.py): `tools/sa_captions.py`
- [Privacy sweep](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_privacy_sweep.py): `tools/sa_privacy_sweep.py`
- [Sync check](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_check_sync.py): `tools/sa_check_sync.py`
- [Final review](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_finalcheck.py): `tools/sa_finalcheck.py`

### Editing and CapCut

- [CapCut assembly](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_assemble.py): `tools/sa_assemble.py`
- [Split-mark editing](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_capcut_split_marks.py): `tools/sa_capcut_split_marks.py`
- [Timeline model](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_timeline.py): `tools/sa_timeline.py`
- [Plan preview](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_plan_preview.py): `tools/sa_plan_preview.py`
- [Marking coverage](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_coverage.py): `tools/sa_coverage.py`
- [Editing style data](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/sa_learn.py): `tools/sa_learn.py`

### Voice and motion

- [Photo workflows](https://github.com/saadahmadofficial1/marketing-house/blob/main/tools/media_kit.py): `tools/media_kit.py`
- [Voice cloning kit](https://github.com/saadahmadofficial1/marketing-house/blob/main/kits/fish-voice-kit/fish_voice.py): `kits/fish-voice-kit/fish_voice.py`
- [Slide narration](https://github.com/saadahmadofficial1/marketing-house/blob/main/playbooks/templates/remotion/SlideNarration.tsx): `playbooks/templates/remotion/SlideNarration.tsx`

### AI workspace

- [Knowledge server](https://github.com/saadahmadofficial1/marketing-house/blob/main/workspace-kit/brain/server.py): `workspace-kit/brain/server.py`
- [Local retrieval](https://github.com/saadahmadofficial1/marketing-house/blob/main/workspace-kit/brain/rag.py): `workspace-kit/brain/rag.py`

### Local services

- [Studio MCP](https://github.com/saadahmadofficial1/marketing-house/blob/main/mcp/studio/server.py): `mcp/studio/server.py`
- [Photo cull driver](https://github.com/saadahmadofficial1/marketing-house/blob/main/mcp/studio/cull_driver.py): `mcp/studio/cull_driver.py`

### Other components

- **Producer**
- **CapCut editor**
- **Human reviewer**

## Connections

- Producer → Screen intake: reads recording
- Screen intake → Phone training build: feeds OCR (evidence: `tools/sa_appbuild.py`)
- Phone training build → Step call-outs: renders call-outs (evidence: `tools/sa_appbuild.py`)
- Producer → Voice anchors: anchors voice
- Producer → Script captions: makes captions
- Producer → Privacy sweep: checks privacy
- Producer → Sync check: checks sync
- Producer → Final review: audits cut
- Producer → CapCut assembly: builds timeline
- Producer → Split-mark editing: edits markings
- Producer → Timeline model: plans timeline
- Timeline model → CapCut assembly: validates plan (evidence: `tools/sa_timeline.py`)
- Producer → Plan preview: previews plan
- Plan preview → Timeline model: validates plan (evidence: `tools/sa_plan_preview.py`)
- Plan preview → CapCut assembly: uses renderer (evidence: `tools/sa_plan_preview.py`)
- Producer → Marking coverage: checks coverage
- Marking coverage → Split-mark editing: reads draft marks
- Producer → Editing style data: learns edit style
- Producer → Photo workflows: works on photos
- Producer → Voice cloning kit: creates voice-over
- Producer → Slide narration: renders narration
- Producer → Knowledge server: queries knowledge
- Knowledge server → Local retrieval: searches chunks (evidence: `workspace-kit/brain/server.py`)
- Producer → Studio MCP: uses local tools
- Studio MCP → Photo cull driver: runs cull
- CapCut assembly → CapCut editor: writes draft (evidence: `tools/sa_assemble.py`)
- CapCut editor → Human reviewer: presents cut
- Human reviewer → Final review: reviews render
