dreamloop 0.1.1__tar.gz → 0.1.2__tar.gz

{dreamloop-0.1.1 → dreamloop-0.1.2}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v0.1.2 - 2026-06-14
+
+DreamLoop's second patch tightens first-screen quality and introduces an explicit image-generation path:
+
+- Reduced Dashboard hero title weight and spacing so the screenshot screen no longer visually overflows.
+- Added subtle page-enter transitions and sidebar active-state motion, with `prefers-reduced-motion` support.
+- Fixed the language toggle mojibake so Chinese renders as `中文`.
+- Added optional image provider configuration: local visual cards by default, ComfyUI readiness checks, and a custom OpenAI-compatible cloud image endpoint.
+- Added `dream_images` storage and `.dreamloop/assets/images/` output for generated image files.
+- Added dream image web/API routes and `dreamloop image test`.
+- Gallery now prefers real generated images and falls back to local visual memory cards.
+
 ## v0.1.1 - 2026-06-14
 
 This patch focuses on first-impression reliability and the trust loop around interpretation quality:

{dreamloop-0.1.1 → dreamloop-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dreamloop
-Version: 0.1.1
+Version: 0.1.2
 Summary: A local-first AI dream journal for people who want to notice patterns in their dreams.
 Project-URL: Homepage, https://github.com/saime428/DreamLoop
 Project-URL: Repository, https://github.com/saime428/DreamLoop
@@ -38,6 +38,7 @@ Description-Content-Type: text/markdown
 - Free with Ollama. Optional DeepSeek/OpenAI or custom OpenAI-compatible endpoints.
 - CLI-first, forkable, and built for Obsidian-minded knowledge workers.
 - Detailed dream analysis that favors emotions, real-life context, and multiple verifiable interpretations.
+- Optional dream images are explicit opt-in: local cards by default, OpenAI-compatible cloud endpoints only when configured, and local ComfyUI reserved for workflow-backed generation.
 
 ```bash
 git clone https://github.com/saime428/DreamLoop.git
@@ -162,6 +163,19 @@ Provider defaults:
 - `custom`: any OpenAI-compatible `/v1` endpoint, including local gateways
 - `none`: capture-only local journal mode
 
+## Image Providers
+
+DreamLoop does not call an image API by default. Detail pages always support a local visual-memory card, and real image generation is opt-in. In v0.1.2 the cloud OpenAI-compatible path can generate files; the local ComfyUI option is a configuration and connectivity checkpoint until a workflow is attached.
+
+```bash
+dreamloop image use local_card
+dreamloop image use local_comfyui --base-url http://127.0.0.1:8188
+dreamloop image use cloud_openai_compatible --model image-model --base-url https://images.example/v1
+dreamloop image test
+```
+
+Generated image files are stored under `.dreamloop/assets/images/`; the database stores local metadata such as provider, model, prompt, path, status, and error. ComfyUI readiness can be checked with `dreamloop image test`, but prompt submission stays disabled until a workflow is configured.
+
 ## Web App Loop
 
 The FastAPI/Jinja dashboard is intentionally lightweight:
@@ -170,8 +184,8 @@ The FastAPI/Jinja dashboard is intentionally lightweight:
 - Log: draft-first dream capture, optional reflection prompts, and AI analysis before saving
 - Detail: original dream text, detailed interpretation, reality-grounded questions, raw JSON, and an opt-in visual-memory entry point
 - Patterns: clickable calendar, recurring symbols, theme trends, and filters back into Log
-- Gallery: v0.1 local visual cards derived from saved dreams; image generation remains opt-in
-- Settings: provider selection, launch notes, local data directory, and privacy status
+- Gallery: real generated images when configured, otherwise local visual cards derived from saved dreams
+- Settings: AI provider, image provider, launch notes, local data directory, and privacy status
 
 DreamLoop is currently launched with `uv run dreamloop web` from a checkout or `dreamloop web` after package install. A native desktop app is a later packaging task; v0.1 stays lightweight so the local-first core remains easy to inspect and fork.
 
@@ -183,7 +197,9 @@ The same app exposes JSON endpoints:
 - `GET /api/dreams/{id}/similar`
 - `POST /api/analyze/pending`
 - `POST /api/dreams/{id}/feedback`
+- `POST /api/dreams/{id}/image`
 - `GET /api/feedback/summary`
+- `GET /api/images/status`
 - `POST /api/import/ics`
 - `POST /api/weather/sync`
 - `GET /api/insights/heatmap`
@@ -196,6 +212,7 @@ The same app exposes JSON endpoints:
   dreamloop.sqlite3
   config.json
   secrets.env
+  assets/images/
   chroma/
   exports/
   imports/
@@ -243,6 +260,14 @@ dreamloop web
 - Local feedback buttons on interpretations: resonates, not accurate, unsure.
 - Patterns summary for high-resonance themes.
 
+### v0.1.2
+
+- Dashboard first-screen polish for screenshot quality.
+- Subtle page transitions with reduced-motion support.
+- Optional image provider settings for local visual cards, ComfyUI readiness checks, and custom cloud image endpoints.
+- Real generated image storage in `.dreamloop/assets/images/`.
+- Gallery prefers real dream images and falls back to local visual cards.
+
 ### v0.2
 
 - Markdown export.

{dreamloop-0.1.1 → dreamloop-0.1.2}/README.md

@@ -12,6 +12,7 @@
 - Free with Ollama. Optional DeepSeek/OpenAI or custom OpenAI-compatible endpoints.
 - CLI-first, forkable, and built for Obsidian-minded knowledge workers.
 - Detailed dream analysis that favors emotions, real-life context, and multiple verifiable interpretations.
+- Optional dream images are explicit opt-in: local cards by default, OpenAI-compatible cloud endpoints only when configured, and local ComfyUI reserved for workflow-backed generation.
 
 ```bash
 git clone https://github.com/saime428/DreamLoop.git
@@ -136,6 +137,19 @@ Provider defaults:
 - `custom`: any OpenAI-compatible `/v1` endpoint, including local gateways
 - `none`: capture-only local journal mode
 
+## Image Providers
+
+DreamLoop does not call an image API by default. Detail pages always support a local visual-memory card, and real image generation is opt-in. In v0.1.2 the cloud OpenAI-compatible path can generate files; the local ComfyUI option is a configuration and connectivity checkpoint until a workflow is attached.
+
+```bash
+dreamloop image use local_card
+dreamloop image use local_comfyui --base-url http://127.0.0.1:8188
+dreamloop image use cloud_openai_compatible --model image-model --base-url https://images.example/v1
+dreamloop image test
+```
+
+Generated image files are stored under `.dreamloop/assets/images/`; the database stores local metadata such as provider, model, prompt, path, status, and error. ComfyUI readiness can be checked with `dreamloop image test`, but prompt submission stays disabled until a workflow is configured.
+
 ## Web App Loop
 
 The FastAPI/Jinja dashboard is intentionally lightweight:
@@ -144,8 +158,8 @@ The FastAPI/Jinja dashboard is intentionally lightweight:
 - Log: draft-first dream capture, optional reflection prompts, and AI analysis before saving
 - Detail: original dream text, detailed interpretation, reality-grounded questions, raw JSON, and an opt-in visual-memory entry point
 - Patterns: clickable calendar, recurring symbols, theme trends, and filters back into Log
-- Gallery: v0.1 local visual cards derived from saved dreams; image generation remains opt-in
-- Settings: provider selection, launch notes, local data directory, and privacy status
+- Gallery: real generated images when configured, otherwise local visual cards derived from saved dreams
+- Settings: AI provider, image provider, launch notes, local data directory, and privacy status
 
 DreamLoop is currently launched with `uv run dreamloop web` from a checkout or `dreamloop web` after package install. A native desktop app is a later packaging task; v0.1 stays lightweight so the local-first core remains easy to inspect and fork.
 
@@ -157,7 +171,9 @@ The same app exposes JSON endpoints:
 - `GET /api/dreams/{id}/similar`
 - `POST /api/analyze/pending`
 - `POST /api/dreams/{id}/feedback`
+- `POST /api/dreams/{id}/image`
 - `GET /api/feedback/summary`
+- `GET /api/images/status`
 - `POST /api/import/ics`
 - `POST /api/weather/sync`
 - `GET /api/insights/heatmap`
@@ -170,6 +186,7 @@ The same app exposes JSON endpoints:
   dreamloop.sqlite3
   config.json
   secrets.env
+  assets/images/
   chroma/
   exports/
   imports/
@@ -217,6 +234,14 @@ dreamloop web
 - Local feedback buttons on interpretations: resonates, not accurate, unsure.
 - Patterns summary for high-resonance themes.
 
+### v0.1.2
+
+- Dashboard first-screen polish for screenshot quality.
+- Subtle page transitions with reduced-motion support.
+- Optional image provider settings for local visual cards, ComfyUI readiness checks, and custom cloud image endpoints.
+- Real generated image storage in `.dreamloop/assets/images/`.
+- Gallery prefers real dream images and falls back to local visual cards.
+
 ### v0.2
 
 - Markdown export.

{dreamloop-0.1.1 → dreamloop-0.1.2}/README.zh-CN.md

@@ -12,6 +12,7 @@
 - 支持 Ollama 零成本运行；需要云模型时再显式配置 DeepSeek、OpenAI 或 Custom OpenAI-compatible。
 - CLI 优先、易 fork，适合开发者和 Obsidian 式知识工作流。
 - 解梦更重视情绪、现实处境、多种可验证解释，而不是只给一两句玄学摘要。
+- 梦境图像默认不调用外部 API；先生成本地视觉卡片，需要时再显式接入 OpenAI-compatible 云端图像接口，ComfyUI 暂作为工作流生图的配置预留。
 
 ```bash
 git clone https://github.com/saime428/DreamLoop.git
@@ -83,8 +84,8 @@ DreamLoop v0.1 的产品逻辑是一个完整闭环：
 - Log 录入：高频输入页，先写梦境，也可补充醒来感受、现实关联和个人联想，再点击 AI 分析。
 - Detail 分析：查看梦境原文、详细解梦、现实问题、自我验证问题、原始 JSON，并能给每条解释打反馈。
 - Patterns 规律：可点击梦境日历、符号趋势、主题趋势和高共鸣主题，图表能跳回 Log 过滤记录。
-- Gallery 记忆：v0.1 先展示本地视觉卡片；真实图像生成是 opt-in 路线，不默认调用付费 API。
-- Settings 信任托底：配置模型提供方、查看本地数据目录、确认密钥不回显，并阅读隐私审计说明。
+- Gallery 记忆：优先展示真实生成图像；没有配置图像 provider 时展示本地视觉卡片。
+- Settings 信任托底：配置 AI 提供方、图像提供方、查看本地数据目录、确认密钥不回显，并阅读隐私审计说明。
 
 ## 无 AI 模式也能用
 
@@ -125,6 +126,19 @@ Provider 说明：
 - `custom`：任意 OpenAI-compatible `/v1` 端点，包括本地网关。
 - `none`：只记录和浏览，不做 AI 分析。
 
+## 图像 Provider
+
+DreamLoop 默认不会调用图像 API。详情页始终可以生成本地视觉记忆卡片；真实图像生成需要你显式配置。v0.1.2 中，OpenAI-compatible 云端接口可以生成文件；本地 ComfyUI 先作为配置和连通性检测入口，等绑定 workflow 后再提交生图任务。
+
+```bash
+dreamloop image use local_card
+dreamloop image use local_comfyui --base-url http://127.0.0.1:8188
+dreamloop image use cloud_openai_compatible --model image-model --base-url https://images.example/v1
+dreamloop image test
+```
+
+真实图像文件会写入 `.dreamloop/assets/images/`。数据库只保存 provider、model、prompt、路径、状态和错误信息等本地元数据。ComfyUI 可以用 `dreamloop image test` 检查服务是否在线，但在配置 workflow 前不会启用真实生图按钮。
+
 ## 常见排查
 
 - 页面没有分析：先运行 `dreamloop doctor`，确认 provider 是否 ready。
@@ -156,6 +170,7 @@ Obsidian 路线图：
   dreamloop.sqlite3
   config.json
   secrets.env
+  assets/images/
   chroma/
   exports/
   imports/
@@ -184,6 +199,14 @@ SQLite 保存梦境、分析结果、用户反馈、日历事件和天气摘要
 - Patterns 展示高共鸣主题。
 - Settings 增加隐私审计说明。
 
+### v0.1.2
+
+- 修复 Dashboard 首屏视觉撑爆。
+- 增加轻量页面切换动效，并支持 reduced motion。
+- 增加本地视觉卡片、ComfyUI 连通性检查和自定义云端图像接口配置。
+- 真实图像保存到 `.dreamloop/assets/images/`。
+- Gallery 优先展示真实梦境图像，没有图像时回退到本地视觉卡片。
+
 ### v0.2
 
 - Markdown/Obsidian 导出。

{dreamloop-0.1.1 → dreamloop-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dreamloop"
-version = "0.1.1"
+version = "0.1.2"
 description = "A local-first AI dream journal for people who want to notice patterns in their dreams."
 readme = "README.md"
 requires-python = ">=3.11"

{dreamloop-0.1.1 → dreamloop-0.1.2}/src/dreamloop/__init__.py

@@ -1,3 +1,3 @@
 """DreamLoop local-first dream journal."""
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{dreamloop-0.1.1 → dreamloop-0.1.2}/src/dreamloop/analysis.py

@@ -203,7 +203,11 @@ def save_ai_config(
         config["base_url"] = base_url
     path = dreamloop_dir(root) / "config.json"
     path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text(json.dumps({"ai": config}, ensure_ascii=False, indent=2), encoding="utf-8")
+    payload = json.loads(path.read_text(encoding="utf-8")) if path.exists() else {}
+    if not isinstance(payload, dict):
+        payload = {}
+    payload["ai"] = config
+    path.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
     ensure_gitignore(root)
     return path
 

{dreamloop-0.1.1 → dreamloop-0.1.2}/src/dreamloop/cli.py

@@ -10,14 +10,17 @@ import typer
 
 from .analysis import ai_status, save_ai_config, test_provider_connection
 from .core import DreamLoop
+from .images import image_status, save_image_config, test_image_provider_connection
 
 app = typer.Typer(help="Local-first AI dream journal.")
 import_app = typer.Typer(help="Import local data.")
 weather_app = typer.Typer(help="Sync local context such as weather.")
 ai_app = typer.Typer(help="Configure local and optional cloud AI providers.")
+image_app = typer.Typer(help="Configure optional dream image generation.")
 app.add_typer(import_app, name="import")
 app.add_typer(weather_app, name="weather")
 app.add_typer(ai_app, name="ai")
+app.add_typer(image_app, name="image")
 
 
 @app.command()
@@ -83,6 +86,12 @@ def doctor() -> None:
     typer.echo(f"connection: {test_provider_connection(loop.root)}")
     if status.warning:
         typer.echo(f"warning: {status.warning}")
+    image = image_status(loop.root)
+    typer.echo(f"image_provider: {image.provider}")
+    typer.echo(f"image_model: {image.model or 'none'}")
+    typer.echo(f"image_ready: {image.ready}")
+    if image.warning:
+        typer.echo(f"image_warning: {image.warning}")
     typer.echo("secrets: hidden")
 
 
@@ -163,5 +172,21 @@ def ai_test() -> None:
     typer.echo(test_provider_connection())
 
 
+@image_app.command("use")
+def image_use(
+    provider: str,
+    model: Annotated[str | None, typer.Option("--model")] = None,
+    base_url: Annotated[str | None, typer.Option("--base-url")] = None,
+) -> None:
+    save_image_config(provider=provider, model=model, base_url=base_url)
+    status = image_status()
+    typer.echo(f"Image provider set to {status.provider} ({status.model or 'local card'}).")
+
+
+@image_app.command("test")
+def image_test() -> None:
+    typer.echo(test_image_provider_connection())
+
+
 def main() -> None:
     app()

{dreamloop-0.1.1 → dreamloop-0.1.2}/src/dreamloop/core.py

@@ -19,6 +19,7 @@ from .analysis import (
     normalize_report_payload,
     normalize_text_list,
 )
+from .images import ImageGenerator, build_image_generator, image_status
 
 FEEDBACK_RATINGS = {"resonates", "not_accurate", "unsure"}
 
@@ -28,11 +29,13 @@ class DreamLoop:
         self.root = Path(root or Path.cwd())
         self.data_dir = self.root / ".dreamloop"
         self.db_path = self.data_dir / "dreamloop.sqlite3"
+        self.images_dir = self.data_dir / "assets" / "images"
 
     def init(self) -> None:
         self.data_dir.mkdir(parents=True, exist_ok=True)
         for name in ("chroma", "exports", "imports"):
             (self.data_dir / name).mkdir(parents=True, exist_ok=True)
+        self.images_dir.mkdir(parents=True, exist_ok=True)
         self._ensure_gitignore()
         self._migrate()
 
@@ -118,6 +121,15 @@ class DreamLoop:
                 "SELECT * FROM dream_analyses WHERE dream_id = ? AND language = ?",
                 (dream_id, normalize_language(language)),
             ).fetchone()
+            image = db.execute(
+                """
+                SELECT * FROM dream_images
+                WHERE dream_id = ? AND language = ?
+                ORDER BY CASE WHEN status = 'complete' THEN 0 ELSE 1 END, id DESC
+                LIMIT 1
+                """,
+                (dream_id, normalize_language(language)),
+            ).fetchone()
         if analysis:
             raw_report = parse_json_any(analysis["raw_json"])
             report = normalize_report_payload(raw_report) if isinstance(raw_report, dict) else {}
@@ -133,6 +145,7 @@ class DreamLoop:
             }
         else:
             dream["analysis"] = None
+        dream["image"] = image_from_row(image) if image else None
         return dream
 
     def analyze_pending(
@@ -180,6 +193,7 @@ class DreamLoop:
         self.init()
         with self._connect() as db:
             db.execute("DELETE FROM user_feedback WHERE dream_id = ?", (dream_id,))
+            db.execute("DELETE FROM dream_images WHERE dream_id = ?", (dream_id,))
             db.execute("DELETE FROM dream_analyses WHERE dream_id = ?", (dream_id,))
             cursor = db.execute("DELETE FROM dreams WHERE id = ?", (dream_id,))
             return cursor.rowcount > 0
@@ -304,6 +318,74 @@ class DreamLoop:
             )
         return visual
 
+    def generate_dream_image(
+        self,
+        dream_id: int,
+        *,
+        language: str = "en",
+        generator: ImageGenerator | None = None,
+    ) -> dict[str, Any]:
+        self.init()
+        dream = self.get_dream(dream_id, language=language)
+        prompt = build_dream_image_prompt(dream)
+        status = image_status(self.root)
+        generator = generator or build_image_generator(self.root)
+        provider = getattr(generator, "provider", status.provider) if generator else status.provider
+        model = getattr(generator, "model", status.model) if generator else status.model
+        created_at = datetime.now().isoformat(timespec="seconds")
+        if generator is None:
+            error = status.warning or "Image provider is not ready."
+            with self._connect() as db:
+                image_id = self._store_image_record(
+                    db,
+                    dream_id,
+                    language=language,
+                    provider=provider,
+                    model=model or "",
+                    prompt=prompt,
+                    image_path="",
+                    status="error",
+                    error=error,
+                    created_at=created_at,
+                )
+            raise RuntimeError(f"{error} (image record #{image_id})")
+        try:
+            image_bytes = generator.generate(prompt)
+        except Exception as exc:
+            with self._connect() as db:
+                self._store_image_record(
+                    db,
+                    dream_id,
+                    language=language,
+                    provider=provider,
+                    model=model or "",
+                    prompt=prompt,
+                    image_path="",
+                    status="error",
+                    error=str(exc),
+                    created_at=created_at,
+                )
+            raise
+        filename = f"dream-{dream_id}-{normalize_language(language)}-{datetime.now().strftime('%Y%m%d%H%M%S%f')}.png"
+        image_path = self.images_dir / filename
+        image_path.write_bytes(image_bytes)
+        relative_path = f"assets/images/{filename}"
+        with self._connect() as db:
+            image_id = self._store_image_record(
+                db,
+                dream_id,
+                language=language,
+                provider=provider,
+                model=model or "",
+                prompt=prompt,
+                image_path=relative_path,
+                status="complete",
+                error="",
+                created_at=created_at,
+            )
+            row = db.execute("SELECT * FROM dream_images WHERE id = ?", (image_id,)).fetchone()
+        return image_from_row(row)
+
     def import_ics(self, path: str | Path) -> int:
         self.init()
         events = parse_ics(Path(path).read_text(encoding="utf-8"))
@@ -481,6 +563,40 @@ class DreamLoop:
         )
         db.execute("UPDATE dreams SET analysis_status = 'analyzed' WHERE id = ?", (dream_id,))
 
+    def _store_image_record(
+        self,
+        db: sqlite3.Connection,
+        dream_id: int,
+        *,
+        language: str,
+        provider: str,
+        model: str,
+        prompt: str,
+        image_path: str,
+        status: str,
+        error: str,
+        created_at: str,
+    ) -> int:
+        cursor = db.execute(
+            """
+            INSERT INTO dream_images (
+                dream_id, language, provider, model, prompt, image_path, status, error, created_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+            """,
+            (
+                dream_id,
+                normalize_language(language),
+                provider,
+                model,
+                prompt,
+                image_path,
+                status,
+                error,
+                created_at,
+            ),
+        )
+        return int(cursor.lastrowid)
+
     def _migrate(self) -> None:
         with self._connect() as db:
             db.executescript(
@@ -526,6 +642,19 @@ class DreamLoop:
                     reason TEXT NOT NULL DEFAULT '',
                     created_at TEXT NOT NULL
                 );
+
+                CREATE TABLE IF NOT EXISTS dream_images (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    dream_id INTEGER NOT NULL REFERENCES dreams(id) ON DELETE CASCADE,
+                    language TEXT NOT NULL DEFAULT 'en',
+                    provider TEXT NOT NULL,
+                    model TEXT NOT NULL DEFAULT '',
+                    prompt TEXT NOT NULL,
+                    image_path TEXT NOT NULL DEFAULT '',
+                    status TEXT NOT NULL,
+                    error TEXT NOT NULL DEFAULT '',
+                    created_at TEXT NOT NULL
+                );
                 """
             )
             self._migrate_dreams_table(db)
@@ -667,6 +796,43 @@ def normalize_visual_memory(payload: dict[str, Any]) -> dict[str, Any]:
     return visual
 
 
+def image_from_row(row: sqlite3.Row | None) -> dict[str, Any] | None:
+    if row is None:
+        return None
+    image = dict(row)
+    image["image_url"] = image_url(image.get("image_path", ""))
+    return image
+
+
+def image_url(image_path: str) -> str:
+    if not image_path:
+        return ""
+    if image_path.startswith("assets/"):
+        return f"/dreamloop-assets/{image_path.removeprefix('assets/')}"
+    return f"/dreamloop-assets/{image_path.lstrip('/')}"
+
+
+def build_dream_image_prompt(dream: dict[str, Any]) -> str:
+    analysis = dream.get("analysis") or {}
+    report = analysis.get("report") or {}
+    parts = [
+        "Create a cinematic, dreamlike illustration based on this dream.",
+        f"Dream text: {dream.get('content', '')}",
+    ]
+    if analysis.get("summary"):
+        parts.append(f"Interpretive summary: {analysis['summary']}")
+    if analysis.get("emotional_tone"):
+        parts.append(f"Core emotion: {analysis['emotional_tone']}")
+    symbols = normalize_text_list(analysis.get("symbols"))
+    if symbols:
+        parts.append(f"Important people, objects, and scenes: {', '.join(symbols[:6])}")
+    details = normalize_text_list(report.get("dream_details"))
+    if details:
+        parts.append(f"Concrete dream details to preserve: {', '.join(details[:4])}")
+    parts.append("Avoid text, logos, UI, gore, and literal JSON. Keep it atmospheric but specific.")
+    return " ".join(part for part in parts if part.strip())
+
+
 def demo_samples() -> list[dict[str, Any]]:
     return [
         {