Dream Analyzer

by poltavtcev
5
4
3
2
1
Score: 30/100

Description

AI-powered dream analysis, entity extraction, vector similarity connections, and lucid dreaming dashboard for Obsidian.

Reviews

No reviews yet.

Stats

3
stars
67
downloads
0
forks
47
days
26
days
26
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
7
total issues
7
open issues
0
closed issues
47
commits

Latest Version

a month ago

Changelog

This release completely redesigns how connections between dreams are detected.

Instead of reducing different kinds of similarity to a single score, dream connections are now identified through three independent signals. Each connection also explains why the dreams were linked.

✨ New

  • Narrative Similarity Detects dreams with strongly similar plots, events, or atmosphere using vector similarity.

    • Default threshold: 0.80
  • Dream Signs Detects recurring Characters, Places, Objects, Symbols, and Concepts.

    • Common entities are filtered by global frequency.
    • Default maximum frequency: 4
  • Emotional Resonance Detects dreams sharing meaningful emotional states.

    • Common emotions are filtered to avoid linking large numbers of unrelated dreams.
    • Default maximum frequency: 3
  • Explainable connections Every connection now shows the reason it was found, for example:

    • Shared Dream Signs: Airport, Airplane
    • Emotional Resonance: Irritation
    • Narrative Similarity: 81%

🐛 Fixed

  • Fixed emotions being omitted from dream connection analysis.
  • Fixed the old entity similarity calculation that diluted important Dream Signs in detailed dreams.
  • Fixed double-counting of the current dream during frequency calculation.
  • Prevented keywords from being treated as Dream Signs.

🔧 Changed

  • Removed the old combinedScore calculation.
  • Removed the old entitySim ratio from dream connection analysis.
  • Replaced the single similarityThreshold connection setting with three independent settings:
    • narrativeThreshold
    • dreamSignMaxFrequency
    • emotionMaxFrequency
  • The old similarityThreshold remains only for backward compatibility and entity-context generation.

🔍 Verification

  • Audited all 19 dreams and all 171 possible dream pairs.
  • Verified 47 unique connections / 94 directional links.
  • Re-tested Dream Sign, emotional, and narrative connections.
  • npm run build passes successfully.

README file from

Github

🌙 Dream Analyzer for Obsidian

Dream Analyzer is an AI-assisted dream journaling plugin for Obsidian.

It helps organize dream journals by analyzing dream entries, extracting structured entities, discovering connections between dreams, and tracking recurring themes.

Dream Analyzer uses AI to assist reflection and organization. It does not provide psychological or medical interpretations.


🚀 Features

🧠 AI Dream Analysis

Automatically analyzes dream entries and generates structured information:

  • Dream summaries
  • Characters
  • Places
  • Objects
  • Emotions
  • Symbols
  • Concepts

Supports OpenAI models including:

  • gpt-4o-mini
  • gpt-4o
  • gpt-5-mini

👤 Entity Management

Automatically creates and updates entity notes:

  • Characters
  • Places
  • Objects
  • Emotions
  • Symbols
  • Concepts

Entity notes preserve:

  • Appearance history
  • Related dreams
  • Recurring contexts
  • Connections between experiences

Includes smart duplicate prevention across categories.


🔗 Dream Similarity Analysis

Finds related dreams using combined semantic and entity-based matching:

  • 50% Vector Cosine Similarity
  • 50% Shared Entity Similarity

Displays the most connected dreams based on:

  • Semantic meaning
  • Recurring entities
  • Shared themes

📊 Dream Analytics Dashboard & Indexes

Automatically generates a dream dashboard and separate index notes:

  • Journal and lucidity statistics
  • Dream signs and reality check triggers
  • Emotional trends
  • Recurring concepts and creative ideas
  • Separate Index folder (Index/ or Індекс/) for character, place, object, emotion, symbol, and concept tables.

📅 Calendar and Templater Integration

Provides:

  • Dream note templates
  • Templater compatibility
  • Calendar integration
  • Date picker modal for creating historical dream entries

🔄 Real-Time Synchronization

Automatically updates internal references when:

  • Dream notes are renamed
  • Entity notes are renamed
  • Files are moved inside the vault

🧹 Data Management

Includes utilities for:

  • Database reset
  • Cleanup of generated data
  • Rebuilding analysis indexes

Uses native Obsidian APIs for frontmatter processing.


🔌 Requirements

For live interactive tables in the Dashboard and Index pages, installing the Dataview plugin is highly recommended.


⚙️ Configuration

  1. Open Obsidian Settings -> Dream Analyzer.
  2. Enter your OpenAI API Key (or save it securely via Obsidian SecretStorage).
  3. Select your preferred AI Model and Embedding Model.
  4. Set your base Dreams Storage Folder (defaults to Dreams).

📦 Installation

Via Obsidian Community Plugins (Upcoming)

Search for Dream Analyzer in Obsidian's Community Plugins directory and click Install.

Manual Installation

  1. Download main.js and manifest.json from the latest GitHub Release.
  2. Create a folder in your vault: .obsidian/plugins/dream-analyzer/
  3. Copy main.js and manifest.json into .obsidian/plugins/dream-analyzer/
  4. Reload Obsidian plugins and enable Dream Analyzer.

📄 License

This project is licensed under the MIT License.