Social Agents
kevinbadi/social-agentsReviewed by AI
Checked by RepoPicks Radar on
What is Social Agents?
Social Agents is a set of AI agents you run on your own computer to look after your social accounts: they interview you about your brand, write and schedule posts (short video, long video, carousels, threads), reply to comments and messages, run comment-to-DM funnels and send you a weekly report. There is also a local dashboard showing what they did. It does not talk to Instagram or TikTok itself: everything goes through CreatorOS, a separate online service where you connect the accounts and get a paid API key. You also need Node.js 20+ and either a Claude plan or an Anthropic key.
How easy is it to install Social Agents?
C · install 1 or 2 tools · macOS
- Windows D
- macOS C
- Linux D
macOS gets the best grade: with Node.js 20 or newer you clone the repository and run `npm start creatoros social-agents`, which installs the dependencies and asks for your CreatorOS key, and scheduled jobs can run locally as launchd services. On Windows and Linux that local option does not exist — the README's other path is deploying a Railway worker with your CreatorOS and Anthropic keys — and the drop-a-video skill also needs ffmpeg and whisper installed.
Social Agents on GitHub
- Stars
- 100on Nov 10, 2026
- Downloads
- —all releases
- Growth
- +2stars in 6 days
Stars over time
Facts
- Runs on
- Windows, macOS, Linux
- You need to install
- Node.js, FFmpeg
- To build from source
- Node.js, FFmpeg
- Disk space
- 100 MB–500 MB · estimate
- Accounts or keys
- CreatorOS, Anthropic (or an Anthropic-compatible model)
- Cost
- Free, API costs extra · The code is MIT, but it only works with a CreatorOS account and its cos_live_ API key, plus AI usage on a Claude plan or an Anthropic key; neither price is stated in the repository
- License
- MIT (Permissive)
- Last change on GitHub
- Sep 25, 2026
Social Agents risk signals (6)
- Attentionuseless without a paid service
README: "CreatorOS is the service underneath: it holds your connected socials and does the actual posting, replying, and analytics"; the client only talks to the CreatorOS API with a cos_live_ key, and key or plan management is refused with "Manage your plan and API keys in the CreatorOS app"
AI review
- Attentionunattended agent can run up api bills
README, Railway pathway: "set a spend limit in the Anthropic Console (console.anthropic.com → Billing → Limits) before deploying. The service runs an agent unattended; an uncapped key is an uncapped bill"
AI review
- Attentionagent acts on your accounts on its own
The starter crons publish posts, "triage comments & DMs, reply on-brand" and arm comment-to-DM funnels on schedule; the stated end state is "fully autonomous, with you only reviewing what Social Agents surface"
AI review
- Attentionagent follows instructions from external videos
README: before building a new automation pattern the agent "checks the index, fetches the tutorial, and follows the taught pattern" from social-agents/knowledge/TUTORIALS.md, a list of the author's YouTube tutorials, so content from outside the repository can steer what the agent does
AI review
- Infoinstalls dependencies on first start
Quick start says "No npm install needed — first start installs for you", and package.json runs scripts/ensure-deps.mjs before start, dashboard, worker and test
AI review
- Infoearly version no releases
package.json version 0.1.0, no GitHub releases, 98 stars, repository created on 2026-07-13
AI review
Evidence is shown in its original language.
What Radar could not check about Social Agents
- What CreatorOS costs and whether its account connections work for a given network
- How much the AI usage costs per month when the agents run on a schedule
- Whether the code-level endpoint allowlist really blocks everything outside the documented table
- What the agents actually publish when running unattended, and how often mistakes need correcting
- Whether the whole flow works on Windows and Linux, since the local schedule option is macOS-only