# muneesraja/auto-startups-vast architecture

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

- Interactive diagram: https://gitdiagram.com/muneesraja/auto-startups-vast
- Repository: https://github.com/muneesraja/auto-startups-vast

## Overview

Aurora is documented as a Vast.ai GPU provisioning system: an operator requests a server, Aurora provisions it, bootstrap setup can run an optional workflow download, and notifications report readiness. The tree includes Vast.ai provisioning code and many separate story-production and publishing skills. The README names bootstrap/workflow scripts that are absent from the supplied tree, so those implementation nodes are not mapped. Story-maker links reflect only relationships visible in the supplied excerpts or SOURCE INDEX; unsampled subsystems are not assumed to call one another.

Main entry points: [`skills/social-publisher/main.py`](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/main.py) (Publisher entry), [`skills/story-maker/main.py`](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/main.py) (Story pipeline), [`skills/vast-ai/scripts`](https://github.com/muneesraja/auto-startups-vast/tree/main/skills/vast-ai/scripts) (Aurora agent), [`skills/vast-ai/scripts/provisioning.py`](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/vast-ai/scripts/provisioning.py) (Provisioning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_infra["GPU provisioning"]
  node_aurora["Aurora agent"]
  node_provision["Provisioning<br/>[provisioning.py]"]
  node_bootstrap["Bootstrap setup"]
  node_workflow["Workflow download"]
end

subgraph group_story["Story production"]
  node_story_cli["Story pipeline<br/>[main.py]"]
  node_profiles["Style profiles<br/>[profiles.py]"]
  node_planning["Plan pipeline"]
  node_artifact["Artifact saving"]
  node_image_pipeline["Image generation<br/>[image_pipeline.py]"]
  node_asset_registry[("Asset registry<br/>[image_pipeline.py]")]
  node_authoring["Mastra authoring<br/>[authoring.ts]"]
end

subgraph group_publish["Social publishing"]
  node_social_cli["Publisher entry<br/>[main.py]"]
  node_media["Media serving<br/>[media_server.py]"]
  node_drive["Drive access<br/>[drive.py]"]
  node_sheets[("Sheet state<br/>[sheets.py]")]
  node_publisher_state[("Publish state<br/>[state.py]")]
  node_instagram["Instagram<br/>[instagram.py]"]
  node_youtube["YouTube<br/>[youtube.py]"]
end

node_operator(("Operator"))
node_vast["Vast.ai"]
node_discord["Discord webhook"]

node_operator -->|"requests provisioning"| node_aurora
node_aurora -.->|"provisions server"| node_provision
node_provision -.->|"creates instance"| node_vast
node_vast -->|"runs on boot"| node_bootstrap
node_bootstrap -->|"runs optionally"| node_workflow
node_bootstrap -->|"notifies readiness"| node_discord
node_story_cli -->|"resolves style"| node_profiles
node_story_cli -->|"uses planning nodes"| node_planning
node_story_cli -->|"uses save nodes"| node_artifact
node_planning -->|"references save nodes"| node_artifact
node_image_pipeline -->|"reads and updates"| node_asset_registry
node_authoring -.->|"coordinates Python"| node_story_cli
node_social_cli -->|"calls"| node_drive
node_social_cli -->|"calls"| node_media
node_social_cli -->|"calls"| node_sheets
node_social_cli -->|"calls"| node_publisher_state
node_social_cli -->|"dispatches to"| node_instagram
node_social_cli -->|"dispatches to"| node_youtube

click node_aurora "https://github.com/muneesraja/auto-startups-vast/tree/main/skills/vast-ai/scripts"
click node_provision "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/vast-ai/scripts/provisioning.py"
click node_story_cli "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/main.py"
click node_profiles "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/profiles.py"
click node_planning "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/scripts/nodes/plan_pipeline_nodes.py"
click node_artifact "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/scripts/nodes/save_artifact_nodes.py"
click node_image_pipeline "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker-v5/tools/image_pipeline.py"
click node_asset_registry "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker-v5/tools/image_pipeline.py"
click node_authoring "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker-v5-mastra/src/mastra/lib/authoring.ts"
click node_social_cli "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/main.py"
click node_media "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/media_server.py"
click node_drive "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/drive.py"
click node_sheets "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/sheets.py"
click node_publisher_state "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/state.py"
click node_instagram "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/publishers/instagram.py"
click node_youtube "https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/publishers/youtube.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_aurora,node_provision,node_bootstrap,node_workflow toneBlue
class node_story_cli,node_profiles,node_planning,node_artifact,node_image_pipeline,node_asset_registry,node_authoring toneAmber
class node_social_cli,node_media,node_drive,node_sheets,node_publisher_state,node_instagram,node_youtube,node_discord toneMint
class node_operator,node_vast toneIndigo
```

## Components

### GPU provisioning

- [Aurora agent](https://github.com/muneesraja/auto-startups-vast/tree/main/skills/vast-ai/scripts): `skills/vast-ai/scripts`
- [Provisioning](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/vast-ai/scripts/provisioning.py): `skills/vast-ai/scripts/provisioning.py`
- **Bootstrap setup**
- **Workflow download**

### Story production

- [Story pipeline](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/main.py): `skills/story-maker/main.py`
- [Style profiles](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/profiles.py): `skills/story-maker/profiles.py`
- [Plan pipeline](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/scripts/nodes/plan_pipeline_nodes.py): `skills/story-maker/scripts/nodes/plan_pipeline_nodes.py`
- [Artifact saving](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker/scripts/nodes/save_artifact_nodes.py): `skills/story-maker/scripts/nodes/save_artifact_nodes.py`
- [Image generation](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker-v5/tools/image_pipeline.py): `skills/story-maker-v5/tools/image_pipeline.py`
- [Asset registry](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker-v5/tools/image_pipeline.py): `skills/story-maker-v5/tools/image_pipeline.py`
- [Mastra authoring](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/story-maker-v5-mastra/src/mastra/lib/authoring.ts): `skills/story-maker-v5-mastra/src/mastra/lib/authoring.ts`

### Social publishing

- [Publisher entry](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/main.py): `skills/social-publisher/main.py`
- [Media serving](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/media_server.py): `skills/social-publisher/media_server.py`
- [Drive access](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/drive.py): `skills/social-publisher/drive.py`
- [Sheet state](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/sheets.py): `skills/social-publisher/sheets.py`
- [Publish state](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/state.py): `skills/social-publisher/state.py`
- [Instagram](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/publishers/instagram.py): `skills/social-publisher/publishers/instagram.py`
- [YouTube](https://github.com/muneesraja/auto-startups-vast/blob/main/skills/social-publisher/publishers/youtube.py): `skills/social-publisher/publishers/youtube.py`

### Other components

- **Operator**
- **Vast.ai**
- **Discord webhook**

## Connections

- Operator → Aurora agent: requests provisioning (evidence: `README.md`)
- Aurora agent → Provisioning: provisions server
- Provisioning → Vast.ai: creates instance
- Vast.ai → Bootstrap setup: runs on boot (evidence: `README.md`)
- Bootstrap setup → Workflow download: runs optionally (evidence: `README.md`)
- Bootstrap setup → Discord webhook: notifies readiness (evidence: `README.md`)
- Story pipeline → Style profiles: resolves style (evidence: `skills/story-maker/main.py`)
- Story pipeline → Plan pipeline: uses planning nodes (evidence: `skills/story-maker/main.py`)
- Story pipeline → Artifact saving: uses save nodes (evidence: `skills/story-maker/main.py`)
- Plan pipeline → Artifact saving: references save nodes (evidence: `skills/story-maker/scripts/nodes/plan_pipeline_nodes.py`)
- Image generation → Asset registry: reads and updates (evidence: `skills/story-maker-v5/tools/image_pipeline.py`)
- Mastra authoring → Story pipeline: coordinates Python
- Publisher entry → Drive access: calls (evidence: `skills/social-publisher/main.py`)
- Publisher entry → Media serving: calls (evidence: `skills/social-publisher/main.py`)
- Publisher entry → Sheet state: calls (evidence: `skills/social-publisher/main.py`)
- Publisher entry → Publish state: calls (evidence: `skills/social-publisher/main.py`)
- Publisher entry → Instagram: dispatches to (evidence: `skills/social-publisher/main.py`)
- Publisher entry → YouTube: dispatches to (evidence: `skills/social-publisher/main.py`)
