tarot-content

# Tarot Content Generator

Create professional tarot × astrology content for social media at scale.

## Capabilities

1. **Weekly 12-Sign Readings** — Scripted horoscope videos with tarot card pulls
2. **Event-Driven Specials** — Content for major transits (retrogrades, eclipses, conjunctions)
3. **Tarot Spreads** — Custom spread designs with interpretation frameworks
4. **Video Scripts** — TTS-ready scripts with screen text cues
5. **Cover Art** — Pillow-generated thumbnails optimized for mobile
6. **Content Calendar** — Automated scheduling based on astrological events

## Quick Start

### Weekly 12-Sign Reading

```
Generate a weekly tarot reading for all 12 signs.
Date range: {start} to {end}
Style: conversational, no jargon
Format: video script with screen text cues
```

The agent will:
1. Pull real ephemeris data (planetary positions, aspects)
2. Map transits to each sign's house system
3. Pull tarot cards (Challenge / Guidance / Blessing spread)
4. Write scripts in a natural, engaging voice

### Event-Driven Special

```
Create a special video about {transit/event}.
Example: Saturn conjunct Neptune in Aries
Include: what it means, historical context, 12-sign breakdown
```

## Content Framework

### The 3-Card Spread (Challenge / Guidance / Blessing)

A proven framework for weekly readings:

| Position | Meaning | Tone |
|----------|---------|------|
| Challenge | What to watch out for | Honest, not scary |
| Guidance | What to focus on | Actionable advice |
| Blessing | What's coming | Hopeful, encouraging |

### Script Structure (per sign, 60-90 seconds)

```
1. Opening hook (5s) — "Hey {Sign}, this week is about..."
2. Transit context (10s) — What planets are doing in their house
3. Card 1: Challenge (15s) — The obstacle + real-life scenario
4. Card 2: Guidance (15s) — Practical advice
5. Card 3: Blessing (10s) — The reward / positive outcome
6. CTA (5s) — "Follow for your sign's weekly reading"
```

### Writing Style Guidelines

- **Say it like a friend, not a fortune teller** — "You might feel stuck" not "The cards reveal stagnation"
- **Use scenarios** — "That coworker drama? Time to set boundaries" not "Conflict in relationships"
- **Numbers in words** — "twenty twenty-six" not "2026" (TTS-friendly)
- **Avoid fear-mongering** — Even tough cards get a constructive spin
- **No clichés** — Ban "the universe has a plan", "trust the process", "everything happens for a reason"

## Ephemeris Data

### Using pyswisseph (recommended)

```python
import swisseph as swe
from datetime import datetime

def get_planet_position(planet_id, dt):
    """Get planet longitude in zodiac."""
    jd = swe.julday(dt.year, dt.month, dt.day, dt.hour + dt.minute/60)
    pos = swe.calc_ut(jd, planet_id)[0]
    longitude = pos[0]
    sign_num = int(longitude / 30)
    degree = longitude % 30
    signs = ['Aries','Taurus','Gemini','Cancer','Leo','Virgo',
             'Libra','Scorpio','Sagittarius','Capricorn','Aquarius','Pisces']
    return signs[sign_num], degree

# Planet IDs: SUN=0, MOON=1, MERCURY=2, VENUS=3, MARS=4,
#             JUPITER=5, SATURN=6, URANUS=7, NEPTUNE=8, PLUTO=9
```

### Install
```bash
pip install pyswisseph
```

## Cover Art Generation

### Pillow-based covers (no AI text artifacts)

```python
from PIL import Image, ImageDraw, ImageFont
import os

def generate_cover(sign, hook_text, date_range, colors, output_path):
    """Generate a 1080x1920 Shorts cover."""
    W, H = 1080, 1920
    img = Image.new('RGB', (W, H))
    draw = ImageDraw.Draw(img)

    # Gradient background
    for y in range(H):
        r = int(colors[0][0] + (colors[1][0]-colors[0][0]) * y/H)
        g = int(colors[0][1] + (colors[1][1]-colors[0][1]) * y/H)
        b = int(colors[0][2] + (colors[1][2]-colors[0][2]) * y/H)
        draw.line([(0,y),(W,y)], fill=(r,g,b))

    # Load fonts (adjust paths for your system)
    font_lg = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 120)
    font_md = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 56)
    font_sm = ImageFont.truetype("/System/Library/Fonts/Helvetica.ttc", 40)

    # Sign name (large, centered)
    draw.text((W//2, H*0.35), sign.upper(), font=font_lg, fill='white', anchor='mm')

    # Date range
    draw.text((W//2, H*0.48), date_range, font=font_md, fill=(255,215,0), anchor='mm')

    # Hook text
    draw.text((W//2, H*0.62), hook_text, font=font_md, fill='white', anchor='mm')

    # Brand
    draw.text((W//2, H*0.78), "WEEKLY TAROT", font=font_sm, fill=(200,200,200), anchor='mm')

    img.save(output_path, quality=95)

# Color schemes per sign
SIGN_COLORS = {
    'aries':       [(220,50,30),  (120,20,60)],
    'taurus':      [(30,120,50),  (15,60,30)],
    'gemini':      [(230,200,40), (180,120,20)],
    'cancer':      [(150,180,220),(60,80,140)],
    'leo':         [(240,170,30), (200,100,10)],
    'virgo':       [(80,140,80),  (40,80,50)],
    'libra':       [(200,160,200),(120,80,150)],
    'scorpio':     [(140,20,40),  (60,10,40)],
    'sagittarius': [(160,80,180), (100,40,120)],
    'capricorn':   [(80,60,50),   (30,25,20)],
    'aquarius':    [(40,100,220), (20,50,140)],
    'pisces':      [(160,130,200),(80,60,130)],
}
```

### Cover Rules
- ⚠️ **Never use Unicode zodiac symbols** (♈♉ etc.) — most fonts render them as ☒
- Use English sign names in large text instead
- Text must be readable at thumbnail size (phone screen)
- Keep important elements away from bottom 15% (YouTube UI overlay)

## Content Calendar

### Weekly Cycle
| Day | Content | Platform |
|-----|---------|----------|
| Mon | 12 sign readings (video) | YouTube Shorts, TikTok |
| Wed | Mid-week energy check | Instagram Reel |
| Fri | Weekend tarot pull | TikTok, Shorts |

### Event-Driven (auto-detect from ephemeris)
- Mercury Retrograde → "Survival guide" series
- Full/New Moon → Moon ritual + tarot spread
- Eclipse season → "Eclipse portal" specials
- Major conjunctions → Deep-dive explainer + 12-sign impact

## Sensitive Content Notes

Platform content policies vary. Avoid:
- Health/medical claims ("this card says you'll recover")
- Financial advice ("invest now, Jupiter says so")
- Fear-inducing predictions ("danger ahead", "death card means...")
- Always frame readings as reflection tools, not predictions