| | --- |
| | 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 |
| |
|
