Transform your thoughts into beautiful poetry, stories, and wisdom using AI-powered specialist agents.

What is Echo Journal? #

Write your memories, secrets, or daily reflections, and watch as a team of AI specialists transforms them into:

• 📝 Poems - Expressive verse with vivid imagery
• 🍃 Haikus - Traditional Japanese 5-7-5 syllable poetry
• 📖 Stories - Narrative tales with depth and emotion
• 🎵 Décimas - Latin American poetry with traditional rhythm (10 lines, 8 syllables)
• 💡 Wisdom - Distilled life lessons and timeless insights

Available in English and Spanish 🌍

How It Works: The Multi-Agent System #

Simple Overview #

flowchart LR
    A[📝 Your Text] --> B[🔍 Analysis<br/>Agent]
    B --> C{🎭 Orchestrator}
    C --> D1[✍️ Poet<br/>Agent]
    C --> D2[✍️ Haiku<br/>Agent]
    C --> D3[✍️ Story<br/>Agent]
    D1 --> E[✅ Validator<br/>Agent]
    D2 --> E
    D3 --> E
    E --> F{Quality<br/>Check}
    F -->|Approved| G[✨ Your<br/>Transformation]
    F -->|Needs Work| H[🔄 Refine]
    H --> D1

    style A fill:#e1f5ff
    style G fill:#d4edda
    style C fill:#fff3cd
    style B fill:#ffe8e8
    style E fill:#d4edda
    style F fill:#fff3cd

The 4 Agent Types #

Semantic Analyst #

Performs deep content analysis:

• Extracts themes: memory, love, loss, growth, hope, nature, time, dreams
• Identifies emotions: joy, sadness, nostalgia, fear, peace, longing
• Measures complexity (0-10) and universality (0-10)
• Discovers metaphors and cultural references

Specialist Writers (5 agents) #

Each expert focuses on one style:

• Poet - Free verse with rich imagery and metaphors
• Haiku Master - Perfect 5-7-5 syllable structure with nature themes
• Storyteller - Compelling narratives with character and scene
• Décima Expert - Traditional 10-line verse with ABBAACCDDC rhyme scheme
• Wisdom Keeper - Timeless teachings and universal truths

All use GPT-4o with temperature 0.8 for creative output

Validator #

Quality assurance with multi-criteria scoring (0-1 scale):

• Emotional resonance - Does it capture the feeling?
• Technical correctness - Proper format (syllables, rhyme, structure)?
• Creativity - Original and imaginative?
• Readability - Clear and engaging?

Recommendations:

• Score ≥ 7.0 → ✅ Approved
• Score 3-7 → 🔄 Needs Refinement (with specific suggestions)
• Score < 3 → ❌ Rejected (retry with different approach)

Uses GPT-4o with temperature 0.2 for consistent evaluation.

Orchestrator #

Master coordinator that:

• Intelligently selects styles based on semantic analysis
• Manages workflow: sequential (one at a time) or parallel (multiple styles)
• Sends targeted feedback for refinements
• Handles up to 3 retry attempts per transformation

Smart style selection:

• Complexity > 6 + metaphors → Poem
• Universality > 7 + simplicity → Haiku
• Narrative structure detected → Story
• Life lessons/reflection → Wisdom
• Spanish language/cultural references → Décima

Technical Highlights #

• Frontend: React + Vite + TanStack Query + shadcn/ui
• Backend: Express.js + TypeScript (service-oriented architecture)
• AI Engine: OpenAI GPT-4o via openai-agents library
• Deployment: Vercel serverless functions
• Storage: In-memory (serverless-ready), PostgreSQL-ready with Drizzle ORM

Key Features: #

• Centralized agent configuration (server/config/agent-config.ts)
• Automatic quality validation with scoring
• Feedback-driven refinement loops (max 3 attempts)
• Bilingual support (English/Spanish)
• Specialized tools: syllable counter for haiku/décima validation
• Timeout handling: 15s (analysis), 20s (writing), 60s (total)