ContentCraft-Agents

AI-Powered Multi-Agent Content Creation Platform

Lightweight • Modern • Production-Ready

About

ContentCraft-Agents is an AI-powered multi-agent orchestration platform that automates content creation through specialized AI agents. The system uses a pipeline approach where different agents handle ideation, research, structuring, writing, and formatting to produce high-quality, research-backed content.

Perfect for: Content creators, marketers, researchers, and businesses looking to scale their content production with AI assistance.

Demo

ContentCraft.mp4

Quick Start

Prerequisites: Docker and Docker Compose

1. Clone the repository

git clone https://github.com/SaqlainXoas/ContentCraft-Agents.git
cd ContentCraft-Agents

2. Configure environment

cp .env.example .env
# Edit .env with your API keys (Google Gemini, Serper.dev)

3. Launch the platform

docker-compose up -d

→ Open http://localhost:3000 to start creating content

Features

• Multi-Agent System: Specialized AI agents for ideation, research, writing, and formatting
• Modern Stack: FastAPI + React + LangGraph + Redis
• Real-time Updates: WebSocket communication between frontend and agents
• Vector Search: ChromaDB integration for RAG-enhanced research
• Production Ready: Docker containers with health checks
• Extensible: Modular agent architecture

Architecture

User Input → Ideation → Research → Structure → Writing → Format → Output
              Agent      Agent      Agent      Agent     Agent

Agents:

• Boss Agent: Orchestrates the entire workflow
• Ideation Agent: Generates creative ideas and titles
• Research Agent: Performs web search and RAG
• Structuring Agent: Creates content outlines
• Writing Agent: Generates long-form content
• Formatting Agent: Finalizes presentation

Project Structure

ContentCraft-Agents/
├── backend/                 # FastAPI backend
│   ├── agents/             # AI agent implementations
│   ├── app/                # API routes and core logic
│   ├── orchestration/      # LangGraph workflow
│   ├── storage/            # Vector store and caching
│   └── tests/              # Test suite
├── frontend/               # React frontend
│   ├── src/components/     # UI components
│   ├── src/pages/          # Application pages
│   └── src/services/       # API client
├── docker-compose.yml      # Multi-service setup
└── .env.example           # Configuration template

Installation

Option 1: Docker (Recommended)

git clone https://github.com/SaqlainXoas/ContentCraft-Agents.git
cd ContentCraft-Agents
cp .env.example .env
# Add your API keys to .env
docker-compose up -d

Option 2: Local Development

Backend:

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
redis-server  # Start Redis
uvicorn app.main:app --reload --port 8000

Frontend:

cd frontend
npm install
npm run dev  # Starts on http://localhost:5173

Configuration

Create .env from .env.example and add your API keys:

# Required
GOOGLE_API_KEY=your_google_gemini_api_key
SERPER_API_KEY=your_serper_dev_api_key

# Optional
OPENAI_API_KEY=your_openai_api_key

Get API Keys:

• Google Gemini API
• Serper.dev (web search)
• OpenAI (optional)

Usage

1. Create Project: Define content requirements
2. Agent Pipeline: Watch agents collaborate in real-time
3. Review Output: Get polished, research-backed content

API Example:

curl -X POST http://localhost:8000/api/projects \
  -H "Content-Type: application/json" \
  -d '{
    "title": "AI in Healthcare",
    "brief": "Write about AI applications in healthcare",
    "target_length": 2000
  }'

Development

Backend Commands:

cd backend
pytest tests/ -v --cov=app --cov=agents  # Run tests
uvicorn app.main:app --reload             # Start API server

Frontend Commands:

cd frontend
npm run dev    # Development server
npm run build  # Production build
npm run lint   # Code linting

Docker Commands:

docker-compose build    # Build containers
docker-compose up -d    # Start services
docker-compose logs     # View logs
docker-compose down     # Stop services

Contributing

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Clone your fork locally
3. Create a feature branch
4. Make your changes
5. Test your changes
6. Submit a pull request

Development Setup:

git clone https://github.com/SaqlainXoas/ContentCraft-Agents.git
cd ContentCraft-Agents
cp .env.example .env
docker-compose up -d

Guidelines:

• Follow existing code style
• Add tests for new features
• Update documentation as needed
• Use conventional commit messages

Troubleshooting

Docker Issues:

docker-compose down -v
docker-compose build --no-cache
docker-compose up -d

Common Problems:

• Port conflicts: Change ports in docker-compose.yml
• API key errors: Verify keys in .env file
• Build failures: Clear Docker cache and rebuild

Technology Stack

Backend: FastAPI, LangChain, LangGraph, ChromaDB, Redis, Python 3.10+ Frontend: React 18, Vite, Tailwind CSS, DaisyUI AI Models: Google Gemini, OpenAI GPT (optional) Infrastructure: Docker, Redis, ChromaDB

License

MIT License - You can use, fork, and modify this project freely.

---

Built with ❤️ using LangGraph, FastAPI, and React

⭐ Star us on GitHub • 🐛 Report Issues