---
title: EMAILOUT
emoji: 🔥
colorFrom: pink
colorTo: gray
sdk: docker
pinned: false
license: mit
---

# EMAILOUT - AI-Powered Email Sequence Generator

A Hugging Face Space application for generating personalized email outreach sequences using GPT.

## Features

- 📤 Upload CSV files from Apollo with contact information
- 🎯 Select and customize products for outreach campaigns
- ✏️ Edit email prompt templates for each product
- 🤖 AI-powered sequence generation using GPT (up to 10 emails per contact)
- 📊 Real-time streaming of generated sequences
- 💾 Download sequences as CSV for use in Klenty and other email tools
- 🚀 Smartlead integration for direct campaign creation and lead pushing
- 📈 Run history tracking for all Smartlead pushes

## Setup

1. Set your API keys as secrets in Hugging Face Spaces:
   - Go to Settings → Secrets
   - Add `OPENAI_API_KEY` with your OpenAI API key value
   - Add `SMARTLEAD_API_KEY` with your Smartlead Admin API key value (required for Smartlead integration)
   - Add `SMARTLEAD_CLIENT_API_KEY` with your Smartlead Client API key value (optional, may be required for certain operations)

2. The app will automatically:
   - Create SQLite database in `/data/emailout.db`
   - Store uploaded CSV files in `/data/uploads/`
   - Generate and store email sequences
   - Track Smartlead run history

## Usage

1. **Upload CSV**: Upload your Apollo CSV file with contacts
2. **Select Products**: Choose which products to focus on for outreach
3. **Configure Prompts**: Customize email templates for each product
4. **Generate**: Let AI create personalized sequences for each contact (up to 10 emails per contact)
5. **Export Options**:
   - **Download CSV**: Export sequences as CSV for Klenty, Outreach, etc.
   - **Push to Smartlead**: Directly create campaigns and push leads to Smartlead
6. **View History**: Check run history for all Smartlead pushes

## Tech Stack

- **Frontend**: React + Vite + Tailwind CSS + Framer Motion + React Router
- **Backend**: FastAPI + Python
- **AI**: OpenAI GPT API
- **Database**: SQLite (Hugging Face Spaces persistent storage)
- **Integration**: Smartlead API for campaign management

## API Endpoints

- `POST /api/upload-csv` - Upload CSV file
- `POST /api/save-prompts` - Save prompt templates
- `GET /api/generate-sequences` - Generate sequences (SSE stream)
- `GET /api/download-sequences` - Download sequences as CSV (with all subject/body columns)
- `POST /api/push-to-smartlead` - Push sequences to Smartlead campaign
- `GET /api/smartlead-runs` - Get Smartlead run history

## Smartlead Integration

The app supports direct integration with Smartlead:
- Create new campaigns or use existing ones
- Automatically build sequence templates with variables ({{subject_1}}..{{subject_10}}, {{body_1}}..{{body_10}})
- Push leads with custom variables for personalized sequences
- Track all runs in the Run History page
- Dry run mode for testing without sending to Smartlead

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference