# razzant/ouroboroshub architecture

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

- Interactive diagram: https://gitdiagram.com/razzant/ouroboroshub
- Repository: https://github.com/razzant/ouroboroshub

## Overview

OuroborosHub is a curated skills catalog, not the desktop agent itself. The main workflow is the desktop discovering catalog entries, downloading a skill’s declared files, verifying them, and handing the skill to the host’s review and enablement lifecycle. Skill plugins provide varied capabilities; the README names several examples. The source excerpts focus on selected skill implementations, so connections among those implementations and the catalog are not inferred.

Main entry points: [`skills`](https://github.com/razzant/ouroboroshub/tree/main/skills) (Skill payload files), [`catalog.json`](https://github.com/razzant/ouroboroshub/blob/main/catalog.json) (Skill catalog), [`skills/weather/plugin.py`](https://github.com/razzant/ouroboroshub/blob/main/skills/weather/plugin.py) (Weather widget), [`skills/nanobanana/plugin.py`](https://github.com/razzant/ouroboroshub/blob/main/skills/nanobanana/plugin.py) (Image generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog"]
  node_catalog_json["Skill catalog<br/>[catalog.json]"]
end

subgraph group_payloads["Skill payloads"]
  node_skill_files["Skill payload files"]
  node_weather["Weather widget<br/>[plugin.py]"]
  node_image_gen["Image generation<br/>[plugin.py]"]
  node_music_gen["Music generation<br/>[plugin.py]"]
  node_video_gen["Video generation<br/>[generate.py]"]
  node_search["Web search<br/>[plugin.py]"]
  node_research["Deep research<br/>[plugin.py]"]
end

subgraph group_host["Host lifecycle"]
  node_review["Skill review"]
  node_enable_execute["Enable and execute"]
end

node_desktop(("Ouroboros Desktop"))

node_desktop -->|"discovers"| node_catalog_json
node_desktop -->|"downloads"| node_skill_files
node_catalog_json -->|"declares files"| node_skill_files
node_desktop -->|"submits for review"| node_review
node_review -->|"passes to enablement"| node_enable_execute
node_skill_files -->|"includes"| node_weather
node_skill_files -->|"includes"| node_image_gen
node_skill_files -->|"includes"| node_music_gen
node_skill_files -->|"includes"| node_video_gen
node_skill_files -->|"includes"| node_search
node_skill_files -->|"includes"| node_research

click node_catalog_json "https://github.com/razzant/ouroboroshub/blob/main/catalog.json"
click node_skill_files "https://github.com/razzant/ouroboroshub/tree/main/skills"
click node_weather "https://github.com/razzant/ouroboroshub/blob/main/skills/weather/plugin.py"
click node_image_gen "https://github.com/razzant/ouroboroshub/blob/main/skills/nanobanana/plugin.py"
click node_music_gen "https://github.com/razzant/ouroboroshub/blob/main/skills/music_gen/plugin.py"
click node_video_gen "https://github.com/razzant/ouroboroshub/blob/main/skills/video_gen/scripts/generate.py"
click node_search "https://github.com/razzant/ouroboroshub/blob/main/skills/duckduckgo/plugin.py"
click node_research "https://github.com/razzant/ouroboroshub/blob/main/skills/perplexity/plugin.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_catalog_json toneBlue
class node_skill_files,node_weather,node_image_gen,node_music_gen,node_video_gen,node_search,node_research toneAmber
class node_review,node_enable_execute toneMint
class node_desktop toneIndigo
```

## Components

### Catalog

- [Skill catalog](https://github.com/razzant/ouroboroshub/blob/main/catalog.json): `catalog.json`

### Skill payloads

- [Skill payload files](https://github.com/razzant/ouroboroshub/tree/main/skills): `skills`
- [Weather widget](https://github.com/razzant/ouroboroshub/blob/main/skills/weather/plugin.py): `skills/weather/plugin.py`
- [Image generation](https://github.com/razzant/ouroboroshub/blob/main/skills/nanobanana/plugin.py): `skills/nanobanana/plugin.py`
- [Music generation](https://github.com/razzant/ouroboroshub/blob/main/skills/music_gen/plugin.py): `skills/music_gen/plugin.py`
- [Video generation](https://github.com/razzant/ouroboroshub/blob/main/skills/video_gen/scripts/generate.py): `skills/video_gen/scripts/generate.py`
- [Web search](https://github.com/razzant/ouroboroshub/blob/main/skills/duckduckgo/plugin.py): `skills/duckduckgo/plugin.py`
- [Deep research](https://github.com/razzant/ouroboroshub/blob/main/skills/perplexity/plugin.py): `skills/perplexity/plugin.py`

### Host lifecycle

- **Skill review**
- **Enable and execute**

### Other components

- **Ouroboros Desktop**

## Connections

- Ouroboros Desktop → Skill catalog: discovers (evidence: `README.md`)
- Ouroboros Desktop → Skill payload files: downloads (evidence: `README.md`)
- Skill catalog → Skill payload files: declares files (evidence: `README.md`)
- Ouroboros Desktop → Skill review: submits for review (evidence: `README.md`)
- Skill review → Enable and execute: passes to enablement (evidence: `README.md`)
- Skill payload files → Weather widget: includes (evidence: `README.md`)
- Skill payload files → Image generation: includes (evidence: `README.md`)
- Skill payload files → Music generation: includes (evidence: `README.md`)
- Skill payload files → Video generation: includes (evidence: `README.md`)
- Skill payload files → Web search: includes (evidence: `README.md`)
- Skill payload files → Deep research: includes (evidence: `README.md`)
