An AI-powered marketing campaign assistant that helps businesses create comprehensive marketing strategies through intelligent automation
Campaign AI is a full-stack AI-powered marketing assistant designed to empower small businesses and marketing teams. It streamlines the entire campaign creation process by leveraging a crew of specialized AI agents for market research, strategy development, copywriting, and image generation.
All features are accessible via an intuitive conversational chatbot interface, enabling users to interact naturally with powerful AI tools to plan and execute effective marketing campaigns from start to finish.
- AI-powered market research and trend analysis
- Automated marketing strategy development
- Professional copywriting for ads and social media
- AI-generated visual concepts and imagery
- Conversational chatbot interface for natural interaction
- Secure user authentication and data management
The core of Campaign AI is a sequential workflow where specialized agents build upon each other's work to create a complete marketing package.
[ User Input: "Create a campaign for my new coffee shop" ]
│
▼
┌──────────────────────┐
│ 1. Market Research │
│ (Finds trends, │
│ influencers) │
└──────────────────────┘
│
▼
┌──────────────────────┐
│ 2. Strategy Agent │
│ (Defines message, │
│ audience, tone) │
└──────────────────────┘
│
▼
┌──────────────────────┐
│ 3. Copywriting Agent │
│ (Writes ad copy, │
│ social posts) │
└──────────────────────┘
│
▼
┌──────────────────────┐
│ 4. Image Agent │
│ (Generates visual │
│ concepts & art) │
└──────────────────────┘
│
▼
[ Final Output: Complete Campaign Package ]
Campaign-AI/
├── backend/ # Express.js Backend API
│ ├── controllers/ # Request handlers
│ ├── models/ # Mongoose data models
│ ├── routes/ # API routes
│ ├── utils/ # Helper functions & AI agents
│ └── server.ts # Backend entry point
│
├── frontend/ # Next.js Frontend Application
│ ├── components/ # Reusable React components
│ ├── pages/ # Next.js pages and API routes
│ ├── public/ # Static assets (images, fonts)
│ ├── styles/ # Tailwind CSS & global styles
│ └── utils/ # Frontend helper functions
│
├── .env.example # Example environment variables
├── package.json # Project dependencies & scripts
└── README.md # Project documentation
| Category | Technology |
|---|---|
| Frontend | Next.js, React, TypeScript, Tailwind CSS, Lottie |
| Backend | Node.js, Express.js |
| AI Engine | Google Gemini API |
| Database & Auth | Firebase (User Authentication), MongoDB with Mongoose |
| Utilities | EmailJS (Contact Form) |
Follow these steps to set up and run Campaign AI on your local machine.
- Node.js (v18 or later) and npm
- Google Cloud project with the Gemini API enabled
- Firebase project for user authentication
- MongoDB database instance (local or cloud-hosted via Atlas)
- Clone the Repository:
git clone https://github.com/yourusername/campaign-ai.git
cd campaign-ai- Install Dependencies:
This will install dependencies for both the frontend and backend.
npm install- Configure Environment Variables:
Create a .env file in the root directory and add the following keys. Use .env.example as a template.
# Google Gemini
GEMINI_API_KEY=your_gemini_api_key
# Firebase
FIREBASE_API_KEY=your_firebase_api_key
FIREBASE_AUTH_DOMAIN=your_firebase_auth_domain
FIREBASE_PROJECT_ID=your_firebase_project_id
FIREBASE_STORAGE_BUCKET=your_firebase_storage_bucket
FIREBASE_MESSAGING_SENDER_ID=your_firebase_messaging_sender_id
FIREBASE_APP_ID=your_firebase_app_id
# MongoDB
MONGODB_URI=your_mongodb_connection_string
# EmailJS
EMAILJS_SERVICE_ID=your_emailjs_service_id
EMAILJS_TEMPLATE_ID=your_emailjs_template_id
EMAILJS_PUBLIC_KEY=your_emailjs_public_key- Run the Application:
You'll need two separate terminals to run the backend and frontend servers concurrently.
Terminal 1: Start the Backend Server
npm run backendThe backend API will now be running on http://localhost:5000.
Terminal 2: Start the Frontend Server
npm run frontendOpen your browser and navigate to http://localhost:3000 to access Campaign AI.
POST /api/auth/register # Register new user
POST /api/auth/login # User login
GET /api/auth/profile # Get user profile
GET /api/campaigns # Get all campaigns
POST /api/campaigns # Create new campaign
GET /api/campaigns/:id # Get specific campaign
PUT /api/campaigns/:id # Update campaign
DELETE /api/campaigns/:id # Delete campaign
POST /api/agents/research # Run market research agent
POST /api/agents/strategy # Run strategy agent
POST /api/agents/copywriting # Run copywriting agent
POST /api/agents/image # Run image generation agent
Deploy the backend to platforms like Railway, Render, or Heroku:
- Set up environment variables on your hosting platform
- Configure the start script to
node server.jsorts-node server.ts - Deploy from your Git repository
Deploy the frontend to Vercel or Netlify:
- Build the production bundle:
npm run build - Deploy the
.nextoroutfolder - Configure environment variables as needed
Run the test suite:
# Backend tests
cd backend
npm test
# Frontend tests
cd frontend
npm testContributions are welcome! Feel free to open an issue to discuss a new feature or submit a pull request to improve Campaign AI.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License. See the LICENSE file for more details.
Built with intelligence by the Campaign AI Team
