How akshitahuja/social_post works
SocialMedia Content Studio is a local, human-reviewed workflow for turning an idea into researched LinkedIn content and an infographic, then publishing only after separate approval and confirmation. The web app accepts ideas and review actions; the pipeline clarifies ambiguity, researches evidence, drafts the post, designs and renders the graphic, and persists each revision. Optional LinkedIn OAuth and publishing are separate from generation. The map follows the README and sampled wiring; some route and workflow implementation was omitted, so uncertain links are not shown.
Main entry points: workflow.py Pipeline engine · app.py FastAPI app · linkedin.py LinkedIn client · agents.py Evidence research
Components 20
Web review
- FastAPI app
src/social_post/app.py - Review templates
src/social_post/templates
Content pipeline
- Pipeline engine
src/social_post/workflow.py - Topic clarification
src/social_post/agents.py - Evidence research
src/social_post/agents.py - Post drafting
src/social_post/agents.py - Visual design
src/social_post/agents.py - Infographic renderer
src/social_post/renderer.py - Targeted revision
src/social_post/workflow.py
Workflow state
- Domain schemas
src/social_post/models.py - Workflow repository
src/social_post/storage.py - Flow checkpoints
src/social_post/workflow.py - Rendered PNGs
src/social_post/config.py
LinkedIn publishing
- Publishing service
src/social_post/linkedin.py - LinkedIn client
src/social_post/linkedin.py - OAuth token store
src/social_post/linkedin.py
AI integrations
- Groq LLM
- Serper search
- LinkedIn API
Other components
- Content creator
Connections 24
- Content creator → FastAPI app: submits and reviews
- FastAPI app → Review templates: renders pages
- FastAPI app → Pipeline engine: starts and reviews
- FastAPI app → Workflow repository: reads workflow
- FastAPI app → Publishing service: confirms publish
- FastAPI app → LinkedIn client: handles OAuth
- Pipeline engine → Workflow repository: loads and saves
- Pipeline engine → Topic clarification: requests interpretation
- Pipeline engine → Evidence research: requests research
- Pipeline engine → Post drafting: requests post
- Pipeline engine → Visual design: requests visual brief
- Pipeline engine → Infographic renderer: renders brief
- Pipeline engine → Targeted revision: runs revisions
- Pipeline engine → Flow checkpoints: persists flow
- Infographic renderer → Rendered PNGs: writes PNG
- Topic clarification → Groq LLM: calls LLM
- Evidence research → Serper search: searches evidence
- Evidence research → Groq LLM: synthesizes research
- Post drafting → Groq LLM: generates post
- Visual design → Groq LLM: designs brief
- Publishing service → Workflow repository: loads and records
- Publishing service → LinkedIn client: publishes approved post
- LinkedIn client → OAuth token store: loads and saves tokens
- LinkedIn client → LinkedIn API: exchanges and publishes