sandbox-reports/QUICKSTART.md
DJP facacc94d4 Update AI Tools Usage Report System - Multi-Tool Support
Enhanced the VEO3 usage report system to support all AI tool types:
- Added support for 6 tool types: VEO3, TEXT2IMAGE, TEXT2VOICE, SPEECH2SPEECH, DOCUMENT_TRANSLATION, VIDEOQUERY
- Updated Python report generator (veo3_report.py) with dynamic tool detection
- Updated PHP report page (report.php) with tool usage breakdown section
- Changed all "Prompts" references to "Requests" for clarity
- Updated refresh button to fetch only last 12 weeks (84 days) for better performance
- Made system dynamic to handle unknown tool types automatically
- Renamed report titles from "VEO3 Usage Report" to "AI Tools Usage Report"

Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
2026-01-08 14:50:04 -05:00

2.3 KiB

VEO3 Report - Quick Start Guide

Deploy to Server in 3 Steps

Step 1: Prepare Files

# On your local machine, ensure .env is configured
cp .env.example .env
nano .env  # Add your SMTP credentials

Step 2: Upload to Server

scp veo3_report.py veo3_scheduler.py requirements.txt .env \
    veo3-report.service deploy.sh \
    user@your-server.com:/tmp/veo3-deploy/

Step 3: Deploy

# SSH into server
ssh user@your-server.com

# Run deployment
cd /tmp/veo3-deploy
chmod +x deploy.sh
sudo ./deploy.sh

Done! The service is now running and will send reports daily at 7:00 PM EST.


Common Commands

# Check if service is running
sudo systemctl status veo3-report

# View live logs
sudo journalctl -u veo3-report -f

# Restart service
sudo systemctl restart veo3-report

# Test immediately (without waiting for 7pm)
sudo systemctl stop veo3-report
cd /var/www/veo3-report
sudo -u www-data ./venv/bin/python veo3_report.py
sudo systemctl start veo3-report

Configuration Files

File Location Purpose
.env /var/www/veo3-report/.env SMTP credentials & recipients
veo3_scheduler.py /var/www/veo3-report/ Schedule time & timezone
veo3_report.py /var/www/veo3-report/ Cost per video setting

Changing Settings

Change Email Recipients

sudo nano /var/www/veo3-report/.env
# Edit REPORT_RECIPIENTS line
sudo systemctl restart veo3-report

Change Schedule Time

sudo nano /var/www/veo3-report/veo3_scheduler.py
# Find: CronTrigger(hour=19, minute=0, ...)
# Change hour (24-hour format: 19 = 7pm)
sudo systemctl restart veo3-report

Change Cost Per Video

sudo nano /var/www/veo3-report/veo3_report.py
# Find: COST_PER_VIDEO = 3.20
# Change value
sudo systemctl restart veo3-report

Troubleshooting

Service won't start?

sudo journalctl -u veo3-report -n 50

Emails not sending?

# Test manually
cd /var/www/veo3-report
sudo -u www-data ./venv/bin/python veo3_report.py
# Check output for SMTP errors

Wrong time?

# Service uses EST timezone explicitly in code
# Check: sudo journalctl -u veo3-report | grep "Next scheduled run"

For detailed information, see DEPLOYMENT.md