🎯 IMA Framework — Influencer Marketing Agent

Transform any AI coding tool into a high-performance influencer marketing agency.

IMA is an open-source agentic framework designed for professional influencer marketing research and strategy. Unlike basic search tools, IMA provides a multi-agent squad of specialized personas, structured workflows for every phase of the marketing lifecycle, and a deep knowledge base to ensure every campaign is data-driven and compliant.

⚡ The Agentic Edge

IMA isn't just a set of prompts; it's a methodology. It brings the rigor of software engineering to influencer marketing.

• 🤖 8 Specialist Personas: From discovery experts to ROI analysts.
• 🔄 7 Lifecycle Phases: End-to-end coverage from brand audit to ROI analysis.
• 🆘 Contextual Help: A "meta-skill" that tells you exactly what to do next based on your progress.
• 🎭 Party Mode: Collaborative multi-agent discussions for complex strategy brainstorming.
• 📁 Client-First Architecture: Organized workspaces designed for agencies managing multiple brands.

🏗️ The IMA Team

Meet your new AI marketing department:

| Agent | Persona | Expertise | |:---:|---|---| | 🎯 | Abu Lahya | Agency Director: Session routing, client management, and export orchestration. | | 🧙 | Oussema | Guided Wizard: Smart intake, workflow selection, and progress coaching. | | 🔍 | Younes | Influencer Scout: Cross-platform discovery, profiling, and trend mining. | | 🏢 | Dylan | Brand Strategist: Brand audits, competitor analysis, and audience alignment. | | 📋 | Kushtrim | Campaign Architect: Brief creation, budget planning, and campaign calendars. | | 🔎 | Ahmed | Content Auditor: Quality vetting, authenticity checks, and brand safety. | | 📊 | Michael | ROI Analyst: Performance forecasting, cost benchmarking, and optimization. | | 📧 | Ammar | Outreach Manager: Sequence design, personalized drafting, and negotiation. |

🔄 The Influencer Marketing Lifecycle

IMA guides you through 35+ professional workflows across 7 distinct phases:

1. Setup: Initialize sessions and configure client-specific priorities.
2. Research: Deep-dive into brand positioning and competitor landscape.
3. Discovery: Mine Instagram, TikTok, and YouTube for high-fit creators.
4. Vetting: Validate metrics, content quality, and audience authenticity.
5. Planning: Build campaign briefs, calendars, and performance milestones.
6. Outreach: Design high-conversion sequences and manage negotiations.
7. Analysis: Analyze campaign performance and optimize for future growth.

📖 Common Workflows

Here are a few ways you can use the IMA squad:

1. The "Brand Blitz" (Research Phase)

"Dylan (BA), conduct a full brand audit for our new client. Compare them against [Competitor A] and [Competitor B]. Analysis needs to highlight gaps in their current influencer strategy."

2. The "Diamond Search" (Discovery Phase)

"Younes (SD), find me 15 micro-influencers in the 'Sustainable Home' niche on TikTok. Filter for 5%+ engagement rate and audience primarily in the US."

3. The "Deep Dive" (Vetting Phase)

"Ahmed (AF), run a full audit on [Influencer Handle]. Focus on audience authenticity and brand safety. Michael (RF), benchmark their estimated CPV against industry standards."

4. The "Strategy Session" (Planning Phase)

"Kushtrim (CP), design a 3-month launch campaign for our new product. Include budget breakdown and creative brief. Then, Ammar (OS), prepare an initial outreach sequence for our top 5 candidates."

5. The "Party Mode" Brainstorm

"/ima-party-mode: We need a creative angle for a TikTok campaign. Dylan (Brand), Michael (ROI), and Ahmed (Auditor) — debate the pros and cons of using a 'Comedy' vs 'Educational' approach for our specific audience."

📦 Installation

The IMA framework is installed via an interactive CLI wizard.

# Setup your agency workspace
npx ima-agent .

The wizard will guide you through:

1. AI Tool Selection (Claude Code, Cursor, OpenCode, etc.)
2. Agency Personalization (Name & Niche)
3. Optional API Connections (YouTube Data API v3)

Automated Install (CI/CD):

npx ima-agent . --tool claude --skip-wizard

🚀 How to Use

IMA works where you work — inside your favorite AI coding assistant.

1. Start a Session: Type /ima-orchestrator or ST to have Abu Lahya initialize your workspace.
2. Add a Client: /ima-orchestrator client add "Acme Brand" to create a dedicated sandbox.
3. Ask for Help: Use /ima-help or IH anytime. The framework analyzes your files and suggests the best next workflow.
4. Start a Party: Use /ima-party-mode or PM to bring the whole team together for a strategy brainstorm.

🛠️ Supported Tools

| Tool | Integration Level | Key Feature | |---|---|---| | Claude Code | High | Custom slash commands & .claude/commands | | OpenCode | High | Trigger codes & .opencode/commands | | Cursor | High | Optimized .cursorrules with @file support | | Generic | Standard | Works with any tool that can read Markdown/YAML |

📄 License

This project is licensed under the MIT License.