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
- Stars
- 418โ
- Forks
- 72
- Language
- Python
- License
- Apache-2.0
- Created
- 2025-04-06
- Last push
- 2025-05-05