RepoPicks Radar

Updated every day around 23:30 UTC

Guides

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

9899100101 Nov 4Nov 6Nov 8Nov 10 9899100101 Nov 4Nov 7Nov 10

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

Similar projects

The RepoPicks app

Coming soon: install in 1 click with the RepoPicks app.

Before you download

See the release page on GitHub