# agno-agi/vibe-video architecture

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

- Interactive diagram: https://gitdiagram.com/agno-agi/vibe-video
- Repository: https://github.com/agno-agi/vibe-video

## Overview

Vibe Video turns a natural-language request into a rendered motion-graphics video. AgentOS exposes the coordinating team; it delegates code discovery or optional web research when needed, then the Animator authors a Hyperframes composition, lints and renders it, and returns the video. The graph also includes the documented evaluation harness and shared PostgreSQL setup. Some agent and tool implementations are only excerpted, so uncertain internal steps are omitted.

Main entry points: [`vibe_video/team.py`](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/team.py) (Coordinating Team), [`app/main.py`](https://github.com/agno-agi/vibe-video/blob/main/app/main.py) (AgentOS Service), [`db/session.py`](https://github.com/agno-agi/vibe-video/blob/main/db/session.py) (Postgres Session), [`evals/runner.py`](https://github.com/agno-agi/vibe-video/blob/main/evals/runner.py) (Evaluation Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Request Runtime"]
  node_agentos["AgentOS Service<br/>[main.py]"]
  node_team["Coordinating Team<br/>[team.py]"]
end

subgraph group_agents["Specialist Agents"]
  node_animator["Animator<br/>[animator.py]"]
  node_code_explorer["Code Explorer<br/>[code_explorer.py]"]
  node_researcher["Web Researcher<br/>[researcher.py]"]
  node_git_tools["Git Inspection Tools<br/>[git.py]"]
end

subgraph group_rendering["Video Rendering"]
  node_hyperframes_tools["Hyperframes Tools<br/>[hyperframes.py]"]
end

subgraph group_persistence["Persistence"]
  node_settings["Shared Settings<br/>[settings.py]"]
  node_db_session["Postgres Session<br/>[session.py]"]
  node_db_url["Database URL<br/>[url.py]"]
end

subgraph group_evaluation["Evaluation Harness"]
  node_eval_runner["Evaluation Runner<br/>[runner.py]"]
  node_eval_cases["Prompt Cases<br/>[cases.py]"]
  node_eval_client["SSE Team Client<br/>[client.py]"]
end

node_user(("Video Requester"))
node_git_host["Git Hosting"]
node_hyperframes_cli["Hyperframes CLI"]
node_web_search["Parallel Search API"]
node_postgres[("PostgreSQL")]

node_user -->|"submits prompt"| node_agentos
node_agentos -->|"hosts team"| node_team
node_agentos -->|"configures database"| node_db_session
node_team -->|"delegates video"| node_animator
node_team -->|"delegates code research"| node_code_explorer
node_team -.->|"delegates web research"| node_researcher
node_code_explorer -->|"uses git tools"| node_git_tools
node_git_tools -.->|"clones repositories"| node_git_host
node_researcher -.->|"searches and extracts"| node_web_search
node_animator -->|"authors and renders"| node_hyperframes_tools
node_hyperframes_tools -->|"runs lint and render"| node_hyperframes_cli
node_settings -->|"creates agent database"| node_db_session
node_db_session -->|"uses connection URL"| node_db_url
node_db_session -.->|"connects to"| node_postgres
node_eval_runner -->|"loads cases"| node_eval_cases
node_eval_runner -->|"runs team requests"| node_eval_client
node_eval_client -->|"posts run request"| node_agentos

click node_agentos "https://github.com/agno-agi/vibe-video/blob/main/app/main.py"
click node_team "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/team.py"
click node_animator "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/agents/animator.py"
click node_code_explorer "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/agents/code_explorer.py"
click node_researcher "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/agents/researcher.py"
click node_git_tools "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/tools/git.py"
click node_hyperframes_tools "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/tools/hyperframes.py"
click node_settings "https://github.com/agno-agi/vibe-video/blob/main/vibe_video/settings.py"
click node_db_session "https://github.com/agno-agi/vibe-video/blob/main/db/session.py"
click node_db_url "https://github.com/agno-agi/vibe-video/blob/main/db/url.py"
click node_eval_runner "https://github.com/agno-agi/vibe-video/blob/main/evals/runner.py"
click node_eval_cases "https://github.com/agno-agi/vibe-video/blob/main/evals/cases.py"
click node_eval_client "https://github.com/agno-agi/vibe-video/blob/main/evals/client.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_agentos,node_team toneBlue
class node_animator,node_code_explorer,node_researcher,node_git_tools,node_postgres toneAmber
class node_hyperframes_tools,node_user,node_web_search toneMint
class node_settings,node_db_session,node_db_url toneRose
class node_eval_runner,node_eval_cases,node_eval_client,node_git_host,node_hyperframes_cli toneIndigo
```

## Components

### Request Runtime

- [AgentOS Service](https://github.com/agno-agi/vibe-video/blob/main/app/main.py): `app/main.py`
- [Coordinating Team](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/team.py): `vibe_video/team.py`

### Specialist Agents

- [Animator](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/agents/animator.py): `vibe_video/agents/animator.py`
- [Code Explorer](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/agents/code_explorer.py): `vibe_video/agents/code_explorer.py`
- [Web Researcher](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/agents/researcher.py): `vibe_video/agents/researcher.py`
- [Git Inspection Tools](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/tools/git.py): `vibe_video/tools/git.py`

### Video Rendering

- [Hyperframes Tools](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/tools/hyperframes.py): `vibe_video/tools/hyperframes.py`

### Persistence

- [Shared Settings](https://github.com/agno-agi/vibe-video/blob/main/vibe_video/settings.py): `vibe_video/settings.py`
- [Postgres Session](https://github.com/agno-agi/vibe-video/blob/main/db/session.py): `db/session.py`
- [Database URL](https://github.com/agno-agi/vibe-video/blob/main/db/url.py): `db/url.py`

### Evaluation Harness

- [Evaluation Runner](https://github.com/agno-agi/vibe-video/blob/main/evals/runner.py): `evals/runner.py`
- [Prompt Cases](https://github.com/agno-agi/vibe-video/blob/main/evals/cases.py): `evals/cases.py`
- [SSE Team Client](https://github.com/agno-agi/vibe-video/blob/main/evals/client.py): `evals/client.py`

### Other components

- **Video Requester**
- **Git Hosting**
- **Hyperframes CLI**
- **Parallel Search API**
- **PostgreSQL**

## Connections

- Video Requester → AgentOS Service: submits prompt (evidence: `README.md`)
- AgentOS Service → Coordinating Team: hosts team (evidence: `app/main.py`)
- AgentOS Service → Postgres Session: configures database (evidence: `app/main.py`)
- Coordinating Team → Animator: delegates video (evidence: `vibe_video/team.py`)
- Coordinating Team → Code Explorer: delegates code research (evidence: `vibe_video/team.py`)
- Coordinating Team → Web Researcher: delegates web research (evidence: `vibe_video/team.py`)
- Code Explorer → Git Inspection Tools: uses git tools (evidence: `vibe_video/agents/code_explorer.py`)
- Git Inspection Tools → Git Hosting: clones repositories
- Web Researcher → Parallel Search API: searches and extracts (evidence: `vibe_video/agents/researcher.py`)
- Animator → Hyperframes Tools: authors and renders (evidence: `vibe_video/agents/animator.py`)
- Hyperframes Tools → Hyperframes CLI: runs lint and render (evidence: `vibe_video/tools/hyperframes.py`)
- Shared Settings → Postgres Session: creates agent database (evidence: `vibe_video/settings.py`)
- Postgres Session → Database URL: uses connection URL (evidence: `db/session.py`)
- Postgres Session → PostgreSQL: connects to (evidence: `db/session.py`)
- Evaluation Runner → Prompt Cases: loads cases (evidence: `evals/runner.py`)
- Evaluation Runner → SSE Team Client: runs team requests (evidence: `evals/runner.py`)
- SSE Team Client → AgentOS Service: posts run request (evidence: `evals/client.py`)
