# richardeve1997/content-intelligence-kit architecture

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

- Interactive diagram: https://gitdiagram.com/richardeve1997/content-intelligence-kit
- Repository: https://github.com/richardeve1997/content-intelligence-kit

## Overview

Content Intelligence Kit is an agent-driven toolkit for researching creators and producing short-form videos in a creator’s brand and voice, then preparing or scheduling posts. Its main journey runs from onboarding and research through either a talking-head UI story or a faceless mini-me video, then review and posting. The graph combines documented product stages with sampled Python orchestration and module references; several editing and quality-check details are documented but their implementation was not sampled.

Main entry points: [`kit/research/pipeline.py`](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/pipeline.py) (Research run), [`kit/character/__main__.py`](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/__main__.py) (Character workflow), [`kit/character/store.py`](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/store.py) (Character files), [`kit/onboarding.py`](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/onboarding.py) (Onboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Creator setup"]
  node_onboarding["Onboarding<br/>[onboarding.py]"]
  node_brand["Brand and voice<br/>[brand.py]"]
  node_profile["Creator profile<br/>[config.py]"]
end

subgraph group_research["Content research"]
  node_research_run["Research run<br/>[pipeline.py]"]
  node_creator_sources["Creator sources<br/>[scrape.py]"]
  node_performance["Performance scoring<br/>[performance.py]"]
  node_ranking["Video ranking<br/>[rank.py]"]
  node_research_report["Research report<br/>[report.py]"]
  node_idea_hooks["Idea hooks<br/>[ideas.py]"]
end

subgraph group_video["Video creation"]
  node_ui_story["UI story edit<br/>[finish.py]"]
  node_media_tools["Media processing<br/>[media.py]"]
  node_mini_me["Mini-me video<br/>[pack.py]"]
end

subgraph group_character["Mini-me character"]
  node_character_cli["Character workflow<br/>[__main__.py]"]
  node_image_provider["Image providers<br/>[providers.py]"]
  node_sprite_work["Sprite and poses<br/>[poses.py]"]
  node_face_states["Face states<br/>[faces.py]"]
  node_character_store[("Character files<br/>[store.py]")]
end

subgraph group_publishing["Review and posting"]
  node_review["Quality review<br/>[qa_captions.py]"]
  node_captions["Platform captions<br/>[captions.py]"]
  node_scheduler["Post scheduler<br/>[schedule.py]"]
  node_zernio["Zernio service<br/>[zernio.py]"]
  node_social_platforms(("Social platforms"))
end

node_creator(("Creator"))
node_agent(("Code agent"))

node_creator -->|"requests work"| node_agent
node_agent -->|"starts setup"| node_onboarding
node_onboarding -->|"learns brand"| node_brand
node_onboarding -->|"configures"| node_profile
node_agent -->|"runs research"| node_research_run
node_research_run -->|"gathers posts"| node_creator_sources
node_research_run -->|"gets results"| node_performance
node_research_run -->|"scores videos"| node_ranking
node_research_run -->|"writes report"| node_research_report
node_agent -->|"requests hooks"| node_idea_hooks
node_agent -->|"edits raw take"| node_ui_story
node_ui_story -->|"processes media"| node_media_tools
node_agent -->|"builds character"| node_character_cli
node_character_cli -->|"requests images"| node_image_provider
node_character_cli -->|"builds poses"| node_sprite_work
node_character_cli -->|"builds faces"| node_face_states
node_character_cli -->|"records progress"| node_character_store
node_sprite_work -->|"loads state"| node_character_store
node_face_states -->|"loads state"| node_character_store
node_agent -->|"renders style"| node_mini_me
node_mini_me -.->|"uses character"| node_character_store
node_ui_story -->|"checks edit"| node_review
node_mini_me -->|"checks video"| node_review
node_agent -->|"prepares captions"| node_captions
node_captions -->|"supplies captions"| node_scheduler
node_agent -->|"schedules post"| node_scheduler
node_scheduler -->|"dispatches posts"| node_zernio
node_zernio -->|"publishes to"| node_social_platforms

click node_onboarding "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/onboarding.py"
click node_brand "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/brand.py"
click node_profile "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/config.py"
click node_research_run "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/pipeline.py"
click node_creator_sources "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/scrape.py"
click node_performance "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/performance.py"
click node_ranking "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/rank.py"
click node_research_report "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/report.py"
click node_idea_hooks "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/ideas.py"
click node_ui_story "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/finish.py"
click node_media_tools "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/media.py"
click node_mini_me "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/pack.py"
click node_character_cli "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/__main__.py"
click node_image_provider "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/providers.py"
click node_sprite_work "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/poses.py"
click node_face_states "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/faces.py"
click node_character_store "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/store.py"
click node_review "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/qa_captions.py"
click node_captions "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/post/captions.py"
click node_scheduler "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/post/schedule.py"
click node_zernio "https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/zernio.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_onboarding,node_brand,node_profile toneBlue
class node_research_run,node_creator_sources,node_performance,node_ranking,node_research_report,node_idea_hooks toneAmber
class node_ui_story,node_media_tools,node_mini_me toneMint
class node_character_cli,node_image_provider,node_sprite_work,node_face_states,node_character_store toneRose
class node_review,node_captions,node_scheduler,node_zernio,node_social_platforms,node_creator,node_agent toneIndigo
```

## Components

### Creator setup

- [Onboarding](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/onboarding.py): `kit/onboarding.py`
- [Brand and voice](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/brand.py): `kit/brand.py`
- [Creator profile](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/config.py): `kit/config.py`

### Content research

- [Research run](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/pipeline.py): `kit/research/pipeline.py`
- [Creator sources](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/scrape.py): `kit/research/scrape.py`
- [Performance scoring](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/performance.py): `kit/research/performance.py`
- [Video ranking](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/rank.py): `kit/research/rank.py`
- [Research report](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/report.py): `kit/research/report.py`
- [Idea hooks](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/research/ideas.py): `kit/research/ideas.py`

### Video creation

- [UI story edit](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/finish.py): `kit/finish.py`
- [Media processing](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/media.py): `kit/media.py`
- [Mini-me video](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/pack.py): `kit/character/pack.py`

### Mini-me character

- [Character workflow](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/__main__.py): `kit/character/__main__.py`
- [Image providers](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/providers.py): `kit/character/providers.py`
- [Sprite and poses](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/poses.py): `kit/character/poses.py`
- [Face states](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/faces.py): `kit/character/faces.py`
- [Character files](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/character/store.py): `kit/character/store.py`

### Review and posting

- [Quality review](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/qa_captions.py): `kit/qa_captions.py`
- [Platform captions](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/post/captions.py): `kit/post/captions.py`
- [Post scheduler](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/post/schedule.py): `kit/post/schedule.py`
- [Zernio service](https://github.com/richardeve1997/content-intelligence-kit/blob/main/kit/zernio.py): `kit/zernio.py`
- **Social platforms**

### Other components

- **Creator**
- **Code agent**

## Connections

- Creator → Code agent: requests work (evidence: `README.md`)
- Code agent → Onboarding: starts setup (evidence: `README.md`)
- Onboarding → Brand and voice: learns brand (evidence: `kit/onboarding.py`)
- Onboarding → Creator profile: configures (evidence: `kit/onboarding.py`)
- Code agent → Research run: runs research (evidence: `README.md`)
- Research run → Creator sources: gathers posts (evidence: `kit/research/pipeline.py`)
- Research run → Performance scoring: gets results (evidence: `kit/research/pipeline.py`)
- Research run → Video ranking: scores videos (evidence: `kit/research/pipeline.py`)
- Research run → Research report: writes report (evidence: `kit/research/pipeline.py`)
- Code agent → Idea hooks: requests hooks (evidence: `README.md`)
- Code agent → UI story edit: edits raw take (evidence: `README.md`)
- UI story edit → Media processing: processes media (evidence: `kit/finish.py`)
- Code agent → Character workflow: builds character (evidence: `README.md`)
- Character workflow → Image providers: requests images (evidence: `kit/character/__main__.py`)
- Character workflow → Sprite and poses: builds poses (evidence: `kit/character/__main__.py`)
- Character workflow → Face states: builds faces (evidence: `kit/character/__main__.py`)
- Character workflow → Character files: records progress (evidence: `kit/character/__main__.py`)
- Sprite and poses → Character files: loads state (evidence: `kit/character/poses.py`)
- Face states → Character files: loads state (evidence: `kit/character/faces.py`)
- Code agent → Mini-me video: renders style (evidence: `README.md`)
- Mini-me video → Character files: uses character (evidence: `kit/character/pack.py`)
- UI story edit → Quality review: checks edit (evidence: `README.md`)
- Mini-me video → Quality review: checks video (evidence: `README.md`)
- Code agent → Platform captions: prepares captions (evidence: `README.md`)
- Platform captions → Post scheduler: supplies captions (evidence: `kit/post/__init__.py`)
- Code agent → Post scheduler: schedules post (evidence: `README.md`)
- Post scheduler → Zernio service: dispatches posts (evidence: `kit/post/schedule.py`)
- Zernio service → Social platforms: publishes to (evidence: `README.md`)