# rknarukulla/satori architecture

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

- Interactive diagram: https://gitdiagram.com/rknarukulla/satori
- Repository: https://github.com/rknarukulla/satori

## Overview

Satori is a local, AI-tool-driven analytics assistant: a user asks a question, the AI tool obtains account data, analyzes it, and responds or produces a report. The README describes direct Meta API access as the main path; Python fetchers also provide snapshot-based acquisition for Instagram and other platforms. Prompt files support recurring analysis and content-generation workflows. Several capabilities and routing details are documented but their implementing skill files were not sampled, so those links are based on README statements or left unconnected.

Main entry points: [`config.yaml.example`](https://github.com/rknarukulla/satori/blob/main/config.yaml.example) (Local config), [`data`](https://github.com/rknarukulla/satori/tree/main/data) (Local snapshots), [`fetch.py`](https://github.com/rknarukulla/satori/blob/main/fetch.py) (Instagram fetcher), [`fetch_appstore.py`](https://github.com/rknarukulla/satori/blob/main/fetch_appstore.py) (App Store fetcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_assistant["Assistant workflow"]
  node_ai_tool["AI tool"]
  node_agent_routing["Agent routing<br/>[agents.md]"]
  node_config["Local config"]
end

subgraph group_analysis["Analysis and content"]
  node_weekly["Weekly summary<br/>[weekly-summary.md]"]
  node_post_analysis["Post analysis<br/>[post-analysis.md]"]
  node_caption["Caption generation"]
  node_calendar["Content calendar"]
  node_analytics["Analytics capabilities"]
end

subgraph group_acquisition["Data acquisition"]
  node_ig_fetch["Instagram fetcher<br/>[fetch.py]"]
  node_apple_fetch["App Store fetcher<br/>[fetch_appstore.py]"]
  node_play_fetch["Play Store fetcher<br/>[fetch_playstore.py]"]
  node_linkedin_fetch["LinkedIn fetcher<br/>[fetch_linkedin.py]"]
  node_meta_api["Meta Graph API"]
  node_apple_api["App Store Connect"]
  node_google_api["Google Play APIs"]
  node_linkedin_api["LinkedIn API"]
  node_llama_api["Llama API"]
end

subgraph group_outputs["Data and reports"]
  node_snapshots[("Local snapshots")]
  node_html_reports["HTML reports"]
end

node_user(("User"))

node_user -->|"asks questions"| node_ai_tool
node_ai_tool -->|"reads credentials"| node_config
node_ai_tool -->|"fetches data"| node_meta_api
node_meta_api -->|"returns metrics"| node_ai_tool
node_ai_tool -->|"analyzes data"| node_analytics
node_ai_tool -.->|"requests analysis"| node_llama_api
node_ai_tool -->|"uses prompt"| node_weekly
node_ai_tool -->|"uses prompt"| node_post_analysis
node_ai_tool -->|"uses prompt"| node_caption
node_ai_tool -->|"uses prompt"| node_calendar
node_ai_tool -->|"writes report"| node_html_reports
node_ai_tool -->|"follows role"| node_agent_routing
node_config -->|"configures"| node_ig_fetch
node_ig_fetch -->|"fetches metrics"| node_meta_api
node_ig_fetch -->|"writes snapshot"| node_snapshots
node_config -->|"configures"| node_apple_fetch
node_apple_fetch -->|"fetches store data"| node_apple_api
node_apple_fetch -->|"writes snapshot"| node_snapshots
node_config -->|"configures"| node_play_fetch
node_play_fetch -->|"fetches store data"| node_google_api
node_play_fetch -->|"writes snapshot"| node_snapshots
node_config -->|"configures"| node_linkedin_fetch
node_linkedin_fetch -->|"fetches page data"| node_linkedin_api
node_linkedin_fetch -->|"writes snapshot"| node_snapshots
node_snapshots -.->|"provides snapshots"| node_ai_tool

click node_agent_routing "https://github.com/rknarukulla/satori/blob/main/agents.md"
click node_config "https://github.com/rknarukulla/satori/blob/main/config.yaml.example"
click node_weekly "https://github.com/rknarukulla/satori/blob/main/prompts/weekly-summary.md"
click node_post_analysis "https://github.com/rknarukulla/satori/blob/main/prompts/post-analysis.md"
click node_caption "https://github.com/rknarukulla/satori/blob/main/prompts/caption-generator.md"
click node_calendar "https://github.com/rknarukulla/satori/blob/main/prompts/content-calendar.md"
click node_analytics "https://github.com/rknarukulla/satori/tree/main/skills"
click node_ig_fetch "https://github.com/rknarukulla/satori/blob/main/fetch.py"
click node_apple_fetch "https://github.com/rknarukulla/satori/blob/main/fetch_appstore.py"
click node_play_fetch "https://github.com/rknarukulla/satori/blob/main/fetch_playstore.py"
click node_linkedin_fetch "https://github.com/rknarukulla/satori/blob/main/fetch_linkedin.py"
click node_snapshots "https://github.com/rknarukulla/satori/tree/main/data"
click node_html_reports "https://github.com/rknarukulla/satori/tree/main/reports"

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_ai_tool,node_agent_routing,node_config,node_user toneBlue
class node_weekly,node_post_analysis,node_caption,node_calendar,node_analytics toneAmber
class node_ig_fetch,node_apple_fetch,node_play_fetch,node_linkedin_fetch,node_meta_api,node_apple_api,node_google_api,node_linkedin_api,node_llama_api toneMint
class node_snapshots,node_html_reports toneRose
```

## Components

### Assistant workflow

- **AI tool**
- [Agent routing](https://github.com/rknarukulla/satori/blob/main/agents.md): `agents.md`
- [Local config](https://github.com/rknarukulla/satori/blob/main/config.yaml.example): `config.yaml.example`

### Analysis and content

- [Weekly summary](https://github.com/rknarukulla/satori/blob/main/prompts/weekly-summary.md): `prompts/weekly-summary.md`
- [Post analysis](https://github.com/rknarukulla/satori/blob/main/prompts/post-analysis.md): `prompts/post-analysis.md`
- [Caption generation](https://github.com/rknarukulla/satori/blob/main/prompts/caption-generator.md): `prompts/caption-generator.md`
- [Content calendar](https://github.com/rknarukulla/satori/blob/main/prompts/content-calendar.md): `prompts/content-calendar.md`
- [Analytics capabilities](https://github.com/rknarukulla/satori/tree/main/skills): `skills`

### Data acquisition

- [Instagram fetcher](https://github.com/rknarukulla/satori/blob/main/fetch.py): `fetch.py`
- [App Store fetcher](https://github.com/rknarukulla/satori/blob/main/fetch_appstore.py): `fetch_appstore.py`
- [Play Store fetcher](https://github.com/rknarukulla/satori/blob/main/fetch_playstore.py): `fetch_playstore.py`
- [LinkedIn fetcher](https://github.com/rknarukulla/satori/blob/main/fetch_linkedin.py): `fetch_linkedin.py`
- **Meta Graph API**
- **App Store Connect**
- **Google Play APIs**
- **LinkedIn API**
- **Llama API**

### Data and reports

- [Local snapshots](https://github.com/rknarukulla/satori/tree/main/data): `data`
- [HTML reports](https://github.com/rknarukulla/satori/tree/main/reports): `reports`

### Other components

- **User**

## Connections

- User → AI tool: asks questions (evidence: `README.md`)
- AI tool → Local config: reads credentials (evidence: `README.md`)
- AI tool → Meta Graph API: fetches data (evidence: `README.md`)
- Meta Graph API → AI tool: returns metrics (evidence: `README.md`)
- AI tool → Analytics capabilities: analyzes data (evidence: `README.md`)
- AI tool → Llama API: requests analysis (evidence: `README.md`)
- AI tool → Weekly summary: uses prompt (evidence: `README.md`)
- AI tool → Post analysis: uses prompt (evidence: `README.md`)
- AI tool → Caption generation: uses prompt (evidence: `README.md`)
- AI tool → Content calendar: uses prompt (evidence: `README.md`)
- AI tool → HTML reports: writes report (evidence: `README.md`)
- AI tool → Agent routing: follows role (evidence: `README.md`)
- Local config → Instagram fetcher: configures (evidence: `fetch.py`)
- Instagram fetcher → Meta Graph API: fetches metrics (evidence: `fetch.py`)
- Instagram fetcher → Local snapshots: writes snapshot (evidence: `fetch.py`)
- Local config → App Store fetcher: configures (evidence: `fetch_appstore.py`)
- App Store fetcher → App Store Connect: fetches store data (evidence: `fetch_appstore.py`)
- App Store fetcher → Local snapshots: writes snapshot (evidence: `fetch_appstore.py`)
- Local config → Play Store fetcher: configures (evidence: `fetch_playstore.py`)
- Play Store fetcher → Google Play APIs: fetches store data (evidence: `fetch_playstore.py`)
- Play Store fetcher → Local snapshots: writes snapshot (evidence: `fetch_playstore.py`)
- Local config → LinkedIn fetcher: configures (evidence: `fetch_linkedin.py`)
- LinkedIn fetcher → LinkedIn API: fetches page data (evidence: `fetch_linkedin.py`)
- LinkedIn fetcher → Local snapshots: writes snapshot (evidence: `fetch_linkedin.py`)
- Local snapshots → AI tool: provides snapshots
