eloqpulse

The agent keeps a finger on the pulse of the market.

Setup

This project uses Python 3 with a virtual environment to keep dependencies isolated from your system Python.

Prerequisites

• Python 3.8 or higher
• pip (Python package installer)

Installation

1. Create a virtual environment:

   python3 -m venv venv

2. Activate the virtual environment:

   • On macOS/Linux:

     source venv/bin/activate

   • On Windows:

     venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

4. Verify installation:

   python --version
   pip list

Usage

After activating the virtual environment, you can run any of the scripts:

# Generate narration scripts from Google Slides
python video_generation/generate_narration_script.py --id YOUR_PRESENTATION_ID

# Generate audio files from narration scripts
python video_generation/generate_audio_ssml.py --id YOUR_PRESENTATION_ID

# Export slides as PNG images
python video_generation/generate_thumbnail.py --id YOUR_PRESENTATION_ID

# Generate video with captions
python video_generation/generate_video_caption.py --id YOUR_PRESENTATION_ID

Deactivating the Virtual Environment

When you're done working, deactivate the virtual environment:

deactivate

Debugging

The project includes VS Code/Cursor debug configurations in .vscode/launch.json. Make sure to:

1. Create and activate the virtual environment first
2. Install dependencies
3. Select the Python interpreter from the venv (VS Code/Cursor should detect it automatically)

The debug configurations will automatically use the virtual environment's Python interpreter.