Agentfy-io/Agentfy

๐Ÿค– Agentfy is a modular microservices architecture designed to process user requests and execute workflows across multiple social media platforms. ASK ONCE, LET THE AGENT DO THE REST!

418 โ˜…72 forksPythonUpdated 1y ago

What you need to know

Modular, multi-agent coordination system for automating social media operations (TikTok, Instagram, YouTube, X, WhatsApp) โ€” LLMs translate user intents into goal-driven task chains over an MCP-inspired 'agent operating protocol'. Python 3.11+, Apache-2.0.

Install

git clone https://github.com/callmeiks/Agentfy.git && cd Agentfy
pip install -r requirements.txt
Set platform API keys in .env (OPENAI_API_KEY, X_API_KEY, X_API_SECRET, YOUTUBE_API_KEY, etc. โ€” see config.py)

Usage

  • โ€ขpython run_agent_cli.py # CLI mode for quick testing
  • โ€ขstreamlit run run_agent_app.py # Streamlit web UI at http://localhost:8501
  • โ€ขAdd new sub-agents under agents/, then register in agent_registry.json to extend workflows

Key features

  • โœ“Buyer targeting & outreach, cross-platform promotions, content transformation & posting, automated DM messaging/support, creator discovery & competitor monitoring
  • โœ“Multi-agent communication and collaboration โ€” sub-agents reason, perceive, act together in real time; dynamic routing to most suitable agent/function
  • โœ“Registry-based modular architecture (Perception, Reasoning, Action, Memory pipelines); add/delete agents without touching core logic
  • โœ“Early groundwork for exposing agents as callable microservices (CLI, Streamlit, or FastAPI)

Best for

Automating social media outreach, content posting, and DM workflows across TikTok/Instagram/X/YouTube/WhatsApp for creators and sellers.

Caveats

  • โš Requires individual platform API keys for each service you interact with (TikTok, Twitter/X, YouTube, etc.) โ€” README suggests contacting the team if keys are hard to obtain
  • โš README notes deep integration with platforms is 'in progress' โ€” not all shown capabilities may be fully shipped
  • โš Sponsored by TikHub, which provides data access APIs for TikTok, Douyin, Instagram, YouTube, X, Xiaohongshu, Lemon8, Bilibili
Platforms: macOS ยท Linux ยท Windows

Reviewed 2026-08-07

Topics

ai-agentsai-toolsmodel-context-protocolmulti-agent-systemsopenaiprompt-engineering-toolpythonsocial-media-appsocial-media-automationtikhubworkflow-automation
View on GitHub โ†—
Stars
418โ˜…
Forks
72
Language
Python
License
Apache-2.0
Created
2025-04-06
Last push
2025-05-05