🧠 Agentfy – Multi-Agent System for Social Media

📋 Overview

Agentfy is a modular, multi-agent coordination system purpose-built for automating tasks across social media ecosystems. Architected with a flexible Model Context Protocol (MCP), the system enables intelligent workflow execution by leveraging LLMs to translate user intents into structured, goal-driven task chains.

Agentfy supports multi-agent communication and collaboration, allowing sub-agents to reason, perceive, and act together in real-time. It dynamically selects and routes requests to the most suitable agents and functions — no manual configuration needed.

🧩 Agentfy Capabilities Table

Feature	Example Prompt
🎯 Buyer Targeting & Outreach	"Find me some customers on Instagram and TikTok who are interested in buying a kitchen knife set and DM them my shop's new product: ___."
📢 Cross-Platform Promotions	"I'm hosting a hackathon at USC Viterbi. Here's my event info: ___. Can you send it to people on X and Instagram who may be interested, and also generate and post promo content across my accounts?"
📝 Content Transformation & Posting	Transform ideas, videos, or trends into tailored posts, captions, and media across self-authorized accounts.
🤖 Automated Messaging & Support	“Add a background task for me that automatically replies to customer DMs on TikTok and Instagram (make sure it's in the customer's language).”
🧠 Creator Discovery & Competitor Monitoring	“Find 50 livestreamers or influencers on Instagram and TikTok who would be a good fit to advertise my pillow set, send them a campaign brief.”

⚠️ Notes: Agentfy will integrating deeply with platforms like TikTok, Instagram, YouTube, X, Quora, WhatsApp, and more — ready to power the future of digital ops.

---

🎬 Quick Demos

▶️ 1️⃣ Cross-platform buyer discovery

▶️ 2️⃣ Generation & posting with attachments

▶️ 3️⃣ Video performance & audience portrait

---

🚦 Getting Started

1. Clone the repository git clone https://github.com/callmeiks/Agentfy.git
2. Navigate to the project directory cd Agentfy
3. Install dependencies: pip install -r requirements.txt
4. If you want to , please follow the instructions in the ➕ If You Need to Add New Sub Agents section below.
   • This is optional and not required for basic usage
   • You can skip this step if you are just running the existing agents
5. Set environment variables in .env file
   • Required API keys and configurations can be found in config.py
   • Example .env file:

     OPENAI_API_KEY=your_key_here
     X_API_KEY=your_key_here
     X_API_SECRET=your_secret_here
     YOUTUBE_API_KEY=your_key_here
     ....
     

⚠️ Notes: You need to obtain API keys for the respective platforms you want to interact with (e.g., TikTok, Twitter, YouTube, etc.) If you are having trouble getting the API keys, please contact us lqiu314@gmail.com

🚀 Running the Program

You can interact with the program in two different ways: