How rknarukulla/satori works
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 Local config · data Local snapshots · fetch.py Instagram fetcher · fetch_appstore.py App Store fetcher
Components 20
Assistant workflow
- AI tool
- Agent routing
agents.md - Local config
config.yaml.example
Analysis and content
- Weekly summary
prompts/weekly-summary.md - Post analysis
prompts/post-analysis.md - Caption generation
prompts/caption-generator.md - Content calendar
prompts/content-calendar.md - Analytics capabilities
skills
Data acquisition
- Instagram fetcher
fetch.py - App Store fetcher
fetch_appstore.py - Play Store fetcher
fetch_playstore.py - LinkedIn fetcher
fetch_linkedin.py - Meta Graph API
- App Store Connect
- Google Play APIs
- LinkedIn API
- Llama API
Data and reports
- Local snapshots
data - HTML reports
reports
Other components
- User
Connections 25
- User → AI tool: asks questions
README.md - AI tool → Local config: reads credentials
README.md - AI tool → Meta Graph API: fetches data
README.md - Meta Graph API → AI tool: returns metrics
README.md - AI tool → Analytics capabilities: analyzes data
README.md - AI tool → Llama API: requests analysis
README.md - AI tool → Weekly summary: uses prompt
README.md - AI tool → Post analysis: uses prompt
README.md - AI tool → Caption generation: uses prompt
README.md - AI tool → Content calendar: uses prompt
README.md - AI tool → HTML reports: writes report
README.md - AI tool → Agent routing: follows role
README.md - Local config → Instagram fetcher: configures
fetch.py - Instagram fetcher → Meta Graph API: fetches metrics
fetch.py - Instagram fetcher → Local snapshots: writes snapshot
fetch.py - Local config → App Store fetcher: configures
fetch_appstore.py - App Store fetcher → App Store Connect: fetches store data
fetch_appstore.py - App Store fetcher → Local snapshots: writes snapshot
fetch_appstore.py - Local config → Play Store fetcher: configures
fetch_playstore.py - Play Store fetcher → Google Play APIs: fetches store data
fetch_playstore.py - Play Store fetcher → Local snapshots: writes snapshot
fetch_playstore.py - Local config → LinkedIn fetcher: configures
fetch_linkedin.py - LinkedIn fetcher → LinkedIn API: fetches page data
fetch_linkedin.py - LinkedIn fetcher → Local snapshots: writes snapshot
fetch_linkedin.py - Local snapshots → AI tool: provides snapshots