Upload folder using huggingface_hub

.gitignore

@@ -1,6 +1,18 @@
 deploy_to_hf.py
 .venv
+.env
+.python-version
 __pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.so
+*.egg
+*.egg-info/
+dist/
+build/
+.DS_Store
 MANUAL_DEPLOYMENT.md
 DEPLOYMENT_CHECKLIST.md
 00_START_HERE.md

README.md

@@ -203,7 +203,9 @@ MCP 1st Birthday Hackathon organized by Gradio & HuggingFace (Nov 14-30, 2025)
 
 ## 📹 Demo Video
 
-*[Demo video will be added before Nov 30, 2025 submission deadline]*
+**Video Link**: *[Will be added before Nov 30, 2025 submission deadline]*
+
+**Social Media Post**: https://x.com/aamanlamba/status/1989639180960579874
 
 **Planned Contents** (3-4 minutes):
 1. Introduction to Hellenistic astrology and HERMES (30s)
@@ -212,6 +214,13 @@ MCP 1st Birthday Hackathon organized by Gradio & HuggingFace (Nov 14-30, 2025)
 4. Source research feature (45s)
 5. Real-world applications (30s)
 
+**Recording Guide**:
+- Screen record the live HuggingFace Space
+- Demonstrate each calculator with real examples
+- Show source citations and educational content
+- Highlight MCP architecture and tech stack
+- Available at: https://huggingface.co/spaces/aamanlamba/hermes-astrology
+
 ## 🔧 Installation & Development
 
 ### Local Development

app.py

@@ -3,11 +3,22 @@ import os
 from datetime import datetime
 import json
 
+# Import local modules
+try:
+    from voice_agent import AstrologyVoiceAgent
+    VOICE_AVAILABLE = True
+except ImportError:
+    VOICE_AVAILABLE = False
+    print("Voice agent not available - install elevenlabs package")
+
 # Initialize with sponsor APIs (will be configured with environment variables)
 OPENAI_API_KEY = os.getenv("OPENAI_API_KEY", "")
 ANTHROPIC_API_KEY = os.getenv("ANTHROPIC_API_KEY", "")
 ELEVENLABS_API_KEY = os.getenv("ELEVENLABS_API_KEY", "")
 
+# Initialize voice agent if available
+voice_agent = AstrologyVoiceAgent(agent_type="teaching") if VOICE_AVAILABLE and ELEVENLABS_API_KEY else None
+
 # Essential Dignities Tables
 DOMICILE_RULERS = {
     "Aries": "Mars", "Taurus": "Venus", "Gemini": "Mercury",
@@ -37,6 +48,50 @@ SIGN_TRIPLICITIES = {
     "Cancer": "Water", "Scorpio": "Water", "Pisces": "Water"
 }
 
+# Egyptian Bounds (Terms)
+EGYPTIAN_BOUNDS = {
+    "Aries": [(0, 6, "Jupiter"), (6, 12, "Venus"), (12, 20, "Mercury"), (20, 25, "Mars"), (25, 30, "Saturn")],
+    "Taurus": [(0, 8, "Venus"), (8, 14, "Mercury"), (14, 22, "Jupiter"), (22, 27, "Saturn"), (27, 30, "Mars")],
+    "Gemini": [(0, 6, "Mercury"), (6, 12, "Jupiter"), (12, 17, "Venus"), (17, 24, "Mars"), (24, 30, "Saturn")],
+    "Cancer": [(0, 7, "Mars"), (7, 13, "Venus"), (13, 19, "Mercury"), (19, 26, "Jupiter"), (26, 30, "Saturn")],
+    "Leo": [(0, 6, "Jupiter"), (6, 11, "Venus"), (11, 18, "Saturn"), (18, 24, "Mercury"), (24, 30, "Mars")],
+    "Virgo": [(0, 7, "Mercury"), (7, 17, "Venus"), (17, 21, "Jupiter"), (21, 28, "Mars"), (28, 30, "Saturn")],
+    "Libra": [(0, 6, "Saturn"), (6, 14, "Mercury"), (14, 21, "Jupiter"), (21, 28, "Venus"), (28, 30, "Mars")],
+    "Scorpio": [(0, 7, "Mars"), (7, 11, "Venus"), (11, 19, "Mercury"), (19, 24, "Jupiter"), (24, 30, "Saturn")],
+    "Sagittarius": [(0, 12, "Jupiter"), (12, 17, "Venus"), (17, 21, "Mercury"), (21, 26, "Saturn"), (26, 30, "Mars")],
+    "Capricorn": [(0, 7, "Mercury"), (7, 14, "Jupiter"), (14, 22, "Venus"), (22, 26, "Saturn"), (26, 30, "Mars")],
+    "Aquarius": [(0, 7, "Mercury"), (7, 13, "Venus"), (13, 20, "Jupiter"), (20, 25, "Mars"), (25, 30, "Saturn")],
+    "Pisces": [(0, 12, "Venus"), (12, 16, "Jupiter"), (16, 19, "Mercury"), (19, 28, "Mars"), (28, 30, "Saturn")]
+}
+
+# Decans (Faces)
+DECANS = {
+    "Aries": [(0, 10, "Mars"), (10, 20, "Sun"), (20, 30, "Venus")],
+    "Taurus": [(0, 10, "Mercury"), (10, 20, "Moon"), (20, 30, "Saturn")],
+    "Gemini": [(0, 10, "Jupiter"), (10, 20, "Mars"), (20, 30, "Sun")],
+    "Cancer": [(0, 10, "Venus"), (10, 20, "Mercury"), (20, 30, "Moon")],
+    "Leo": [(0, 10, "Saturn"), (10, 20, "Jupiter"), (20, 30, "Mars")],
+    "Virgo": [(0, 10, "Sun"), (10, 20, "Venus"), (20, 30, "Mercury")],
+    "Libra": [(0, 10, "Moon"), (10, 20, "Saturn"), (20, 30, "Jupiter")],
+    "Scorpio": [(0, 10, "Mars"), (10, 20, "Sun"), (20, 30, "Venus")],
+    "Sagittarius": [(0, 10, "Mercury"), (10, 20, "Moon"), (20, 30, "Saturn")],
+    "Capricorn": [(0, 10, "Jupiter"), (10, 20, "Mars"), (20, 30, "Sun")],
+    "Aquarius": [(0, 10, "Venus"), (10, 20, "Mercury"), (20, 30, "Moon")],
+    "Pisces": [(0, 10, "Saturn"), (10, 20, "Jupiter"), (20, 30, "Mars")]
+}
+
+# Zodiacal Releasing
+ZODIACAL_RELEASING_ORDER = [
+    "Cancer", "Leo", "Virgo", "Libra", "Scorpio", "Sagittarius",
+    "Capricorn", "Aquarius", "Pisces", "Aries", "Taurus", "Gemini"
+]
+
+SIGN_YEARS = {
+    "Cancer": 25, "Leo": 19, "Virgo": 20, "Libra": 8, "Scorpio": 15,
+    "Sagittarius": 12, "Capricorn": 27, "Aquarius": 30, "Pisces": 12,
+    "Aries": 15, "Taurus": 8, "Gemini": 20
+}
+
 def calculate_profections(birth_year: int, target_year: int) -> dict:
     """Calculate annual profections from Ascendant"""
     age = target_year - birth_year
@@ -90,27 +145,111 @@ def assess_planetary_dignity(planet: str, sign: str, is_day_chart: bool) -> dict
 
 def calculate_lots(asc_degree: float, sun_degree: float, moon_degree: float, is_day_chart: bool) -> dict:
     """Calculate traditional Hellenistic lots (Fortuna and Spirit)"""
-    
+
     if is_day_chart:
         # Lot of Fortune (day): Asc + Moon - Sun
         fortune = (asc_degree + moon_degree - sun_degree) % 360
     else:
         # Lot of Fortune (night): Asc + Sun - Moon
         fortune = (asc_degree + sun_degree - moon_degree) % 360
-    
+
     if is_day_chart:
         # Lot of Spirit (day): Asc + Sun - Moon
         spirit = (asc_degree + sun_degree - moon_degree) % 360
     else:
         # Lot of Spirit (night): Asc + Moon - Sun
         spirit = (asc_degree + moon_degree - sun_degree) % 360
-    
+
+    # Convert to sign and degree
+    def deg_to_sign(deg):
+        signs = ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
+                 "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"]
+        sign_num = int(deg // 30)
+        sign_deg = deg % 30
+        return f"{round(sign_deg, 2)}° {signs[sign_num]}"
+
     return {
-        "Lot of Fortune": round(fortune, 2),
-        "Lot of Spirit": round(spirit, 2),
+        "Lot of Fortune": f"{round(fortune, 2)}° ({deg_to_sign(fortune)})",
+        "Lot of Spirit": f"{round(spirit, 2)}° ({deg_to_sign(spirit)})",
         "chart_type": "Day Chart" if is_day_chart else "Night Chart"
     }
 
+def get_bound_ruler(sign: str, degree: float) -> dict:
+    """Get the Egyptian bound (term) ruler for a planet's position"""
+    if sign not in EGYPTIAN_BOUNDS:
+        return {"error": f"Invalid sign: {sign}"}
+
+    bounds = EGYPTIAN_BOUNDS[sign]
+    for start, end, ruler in bounds:
+        if start <= degree < end:
+            return {
+                "sign": sign,
+                "degree": degree,
+                "bound_ruler": ruler,
+                "bound_range": f"{start}-{end}°",
+                "dignity_points": 2
+            }
+
+    return {"error": "Degree out of range (0-30)"}
+
+def get_decan_ruler(sign: str, degree: float) -> dict:
+    """Get the decan (face) ruler for a planet's position"""
+    if sign not in DECANS:
+        return {"error": f"Invalid sign: {sign}"}
+
+    decans = DECANS[sign]
+    for start, end, ruler in decans:
+        if start <= degree < end:
+            return {
+                "sign": sign,
+                "degree": degree,
+                "decan_ruler": ruler,
+                "decan_number": (start // 10) + 1,
+                "decan_range": f"{start}-{end}°",
+                "dignity_points": 1
+            }
+
+    return {"error": "Degree out of range (0-30)"}
+
+def calculate_zodiacal_releasing(starting_sign: str, birth_year: int, target_year: int = None) -> dict:
+    """Calculate Zodiacal Releasing periods (simplified version)"""
+    if starting_sign not in ZODIACAL_RELEASING_ORDER:
+        return {"error": f"Invalid starting sign: {starting_sign}"}
+
+    if target_year is None:
+        target_year = datetime.now().year
+
+    age = target_year - birth_year
+    current_index = ZODIACAL_RELEASING_ORDER.index(starting_sign)
+    accumulated_years = 0
+    periods = []
+
+    # Calculate first 5 periods for display
+    for i in range(5):
+        sign = ZODIACAL_RELEASING_ORDER[(current_index + i) % 12]
+        period_years = SIGN_YEARS[sign]
+
+        start_age = int(accumulated_years)
+        end_age = int(accumulated_years + period_years)
+
+        is_current = start_age <= age < end_age
+
+        periods.append({
+            "period": i + 1,
+            "sign": sign,
+            "years": period_years,
+            "age_range": f"{start_age}-{end_age}",
+            "current": "← CURRENT PERIOD" if is_current else ""
+        })
+
+        accumulated_years += period_years
+
+    return {
+        "starting_sign": starting_sign,
+        "current_age": age,
+        "periods": periods
+    }
+
 def research_hellenistic_topic(query: str) -> str:
     """Research assistant for Hellenistic astrology topics"""
     # This will integrate with OpenAI/Anthropic APIs
@@ -311,7 +450,92 @@ def create_demo():
             
             Used by Valens, Paulus Alexandrinus, and modern practitioners for annual forecasting.
             """)
-        
+
+        with gr.Tab("🎯 Bounds & Decans"):
+            gr.Markdown("""
+            ### Egyptian Bounds (Terms) & Decans (Faces)
+            Calculate the sub-rulerships within each sign for refined essential dignity assessment.
+            """)
+
+            with gr.Row():
+                bound_sign = gr.Dropdown(
+                    choices=list(DOMICILE_RULERS.keys()),
+                    label="Sign",
+                    value="Aries"
+                )
+                bound_degree = gr.Number(label="Degree (0-30)", value=15, minimum=0, maximum=30)
+
+            with gr.Row():
+                bound_btn = gr.Button("Get Bound Ruler", variant="primary")
+                decan_btn = gr.Button("Get Decan Ruler", variant="secondary")
+
+            with gr.Row():
+                bound_output = gr.JSON(label="Bound (Term) Result")
+                decan_output = gr.JSON(label="Decan (Face) Result")
+
+            bound_btn.click(
+                fn=get_bound_ruler,
+                inputs=[bound_sign, bound_degree],
+                outputs=bound_output
+            )
+
+            decan_btn.click(
+                fn=get_decan_ruler,
+                inputs=[bound_sign, bound_degree],
+                outputs=decan_output
+            )
+
+            gr.Markdown("""
+            **About Bounds & Decans:**
+
+            - **Egyptian Bounds** (Terms): Each sign divided into 5 unequal sections ruled by planets (+2 dignity points)
+            - **Decans** (Faces): Each sign divided into 3 equal 10° sections (+1 dignity point)
+
+            These sub-rulers provide more refined assessment of planetary condition and are used in advanced time-lord techniques.
+
+            Source: Vettius Valens, Ptolemy (though he presents his own bounds system)
+            """)
+
+        with gr.Tab("🌟 Zodiacal Releasing"):
+            gr.Markdown("""
+            ### Zodiacal Releasing (Loosing of the Bond)
+            Advanced time-lord system from Vettius Valens using the Lot of Fortune or Spirit.
+            """)
+
+            with gr.Row():
+                zr_starting_sign = gr.Dropdown(
+                    choices=ZODIACAL_RELEASING_ORDER,
+                    label="Starting Sign (where Lot of Fortune/Spirit falls)",
+                    value="Cancer"
+                )
+
+            with gr.Row():
+                zr_birth_year = gr.Number(label="Birth Year", value=1990)
+                zr_target_year = gr.Number(label="Target Year (optional)", value=2025)
+
+            zr_btn = gr.Button("Calculate Zodiacal Releasing Periods", variant="primary")
+            zr_output = gr.JSON(label="ZR Periods")
+
+            zr_btn.click(
+                fn=calculate_zodiacal_releasing,
+                inputs=[zr_starting_sign, zr_birth_year, zr_target_year],
+                outputs=zr_output
+            )
+
+            gr.Markdown("""
+            **About Zodiacal Releasing:**
+
+            From Vettius Valens' "Anthology" - one of the most sophisticated Hellenistic timing techniques.
+
+            - Uses fixed order: Cancer → Leo → Virgo → Libra → Scorpio → Sagittarius → Capricorn → Aquarius → Pisces → Aries → Taurus → Gemini
+            - Each sign has set years: Cancer (25), Leo (19), Virgo (20), Libra (8), etc.
+            - Usually started from Lot of Fortune (general life) or Lot of Spirit (career/reputation)
+            - Periods can be divided into sub-periods for precise timing
+            - Peak periods occur when releasing through the sign opposite your starting lot
+
+            This is a simplified version showing major periods. Full ZR includes minor and sub-minor divisions.
+            """)
+
         with gr.Tab("ℹ️ About"):
             gr.Markdown("""
             ## About HERMES

requirements.txt

@@ -1,9 +1,10 @@
-gradio>=5.0
+gradio>=5.49.0
 openai>=1.0.0
 anthropic>=0.39.0
-elevenlabs>=1.0.0
+elevenlabs>=1.9.0
 python-dotenv>=1.0.0
 pyswisseph>=2.10.0
 pandas>=2.0.0
 numpy>=1.24.0
-huggingface_hub>=0.15.0
+huggingface_hub>=0.25.0
+modal>=0.63.0