AI Dream Interpreter Agent Skill — Analyze Dreams via API

This skill enables AI agents to analyze dreams using psychological and symbolic frameworks via AI Pass API.

Setup

1. Create AI Pass account: aipass.one — $1 free credit
2. Get API key: Developer Dashboard → API Keys
3. Set env: export AIPASS_API_KEY="your-key"

Python Implementation

import os, requests

AIPASS_API_KEY = os.environ["AIPASS_API_KEY"]

def interpret_dream(
    dream: str,
    emotions: str = "",
    context: str = ""
) -> str:
    """
    Interpret a dream using psychological and symbolic frameworks.
    
    Args:
        dream: Description of the dream
        emotions: How the dreamer felt (e.g., "anxious, confused")
        context: Waking life context (e.g., "going through a career change")
    
    Returns:
        Full interpretation including symbols, psychology, reflection questions
    """
    emotions_line = f"\nEmotions felt: {emotions}" if emotions else ""
    context_line = f"\nWaking life context: {context}" if context else ""
    
    prompt = f"""Interpret this dream:

Dream: {dream}{emotions_line}{context_line}

Provide:
1. Core Symbols and their meanings
2. Psychological interpretation (Jungian/Freudian)
3. What emotions or experiences are being processed
4. Universal archetypal theme
5. 3 reflection questions for deeper exploration"""
    
    response = requests.post(
        "https://aipass.one/apikey/v1/chat/completions",
        headers={
            "Authorization": f"Bearer {AIPASS_API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "model": "gpt-5-mini",
            "temperature": 1,
            "max_tokens": 2000,
            "messages": [
                {
                    "role": "system",
                    "content": "You are an expert in dream psychology with deep knowledge of Jungian analysis, Freudian symbolism, and cross-cultural dream interpretation. Provide thoughtful, nuanced interpretations."
                },
                {"role": "user", "content": prompt}
            ]
        },
        timeout=30
    )
    
    return response.json()["choices"][0]["message"]["content"]


# Example
if __name__ == "__main__":
    interpretation = interpret_dream(
        dream="I was flying over my childhood city, but all the buildings were wrong sizes. I felt free but also anxious that I might fall.",
        emotions="free, anxious",
        context="considering a major life change"
    )
    print(interpretation)

curl Example

curl -s -X POST https://aipass.one/apikey/v1/chat/completions \
  -H "Authorization: Bearer $AIPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-mini",
    "temperature": 1,
    "max_tokens": 2000,
    "messages": [
      {
        "role": "system",
        "content": "You are an expert dream interpreter using Jungian and symbolic frameworks."
      },
      {
        "role": "user",
        "content": "Interpret this dream: I was running through a maze that kept changing shape. I felt scared but also excited. Context: stressed about a new job."
      }
    ]
  }' | python3 -c "import json,sys; print(json.load(sys.stdin)['choices'][0]['message']['content'])"

Related Resources

• Live App: AI Dream Interpreter
• Build Your Own Dream Interpreter App
• Developer Dashboard