Documentation

Sessions

Relive your creative process. Numonic groups AI-generated assets by creative session, with AI-powered reflections that summarise what you explored and how your style evolved.

  • Automatic Grouping
  • AI Reflections
  • Session Lanes
  • Lineage Integration

Quick Start

Sessions appear automatically once you have imported assets with generation timestamps. There is nothing to configure.

Browse Sessions

Navigate to /app/sessions from the sidebar. You will see session cards grouped by time period (today, this week, earlier). Each card shows a thumbnail grid, asset count, and time range.

Click any session card to view all assets within it.

Get an AI Reflection

Open a session that contains 50 or more assets. Click the Reflect on this session button. The AI Museum Curator analyses your session and produces a written reflection.

Reflections cost AI credits. You will see the cost before confirming.

How Sessions Are Detected

Session detection is fully automatic. Numonic reads generation timestamps from asset metadata and clusters assets that were created close together in time into the same session.

1. Timestamp extraction

During import, Numonic reads generation timestamps from embedded metadata fields such as creation_date and enqueue_time. These fields are written by generation tools like ComfyUI and Midjourney.

2. Temporal clustering

Assets with generation timestamps that fall within the same time window are grouped into a single session. The clustering algorithm identifies natural gaps between creative bursts.

3. Session card creation

Each cluster becomes a session card with a thumbnail grid, time range, and asset count. Sessions update automatically as new assets are imported.

Practical example

If you generated 20 images in ComfyUI between 2pm and 3pm, then took a break and generated another 15 between 5pm and 5:30pm, Numonic creates two sessions: one for the afternoon batch and one for the evening batch. The gap between 3pm and 5pm signals a natural break in your creative process.

This works regardless of import method. Whether you use Smart Import, Connected Folders, or Desktop Sync, the clustering is based on the generation timestamps in the files themselves.

Session Cards

Each session is represented by a card in the sessions view. Cards provide a visual summary so you can quickly identify the session you are looking for.

What each card shows

  • Thumbnail grid showing a preview of assets in the session
  • Asset count indicating how many images belong to the session
  • Time range showing when the session started and ended
  • Session summary if an AI reflection has been generated for the session

Navigating into a session

Click any session card to open the session detail view. This displays all assets belonging to that session in a grid layout, ordered by generation time.

From the detail view you can inspect individual assets, view lineage relationships between variations, and trigger an AI reflection if the session meets the 50-asset threshold.

Time-based grouping

The sessions list groups cards by time period: today, this week, and earlier. This makes it straightforward to find recent sessions without scrolling through your entire history.

AI Reflections

AI reflections provide a written analysis of a creative session, produced by the AI Museum Curator persona. The curator examines the assets in the session and writes a narrative summary of your creative process.

What the reflection contains

  • Summary of exploration: What subjects, themes, and concepts you worked with during the session
  • Style patterns identified: Recurring visual techniques, colour palettes, or compositional choices the AI detects across your assets
  • Evolution notes: How your approach shifted over the course of the session, including prompt refinements and parameter changes

How to trigger a reflection

Open a session with 50 or more assets. The Reflect on this session button appears at the top of the session detail view. Sessions with fewer than 50 assets do not show the button.

Click the button to begin. You will see the credit cost before confirming. Once confirmed, the AI Museum Curator processes the session and the reflection appears on the session card and detail view.

Credit cost

Each reflection consumes AI credits from your account balance. The cost is displayed before you confirm. If you do not have enough credits, the InsufficientCreditsModal appears with an option to purchase more.

The 50-asset threshold

Reflections require a minimum of 50 assets in the session. This threshold ensures the AI has enough material to produce a meaningful analysis of your creative process rather than a trivial summary.

Session Lanes

Session lanes present your sessions as horizontal rows within the gallery view, giving you an alternative way to browse your creative history without leaving the main gallery.

How lanes work

Each session appears as a horizontal lane showing thumbnails from that session. Scroll horizontally within a lane to browse its assets. Each lane also displays a session summary if a reflection exists.

Switching between views

Use the sidebar to switch between the standard gallery grid and the sessions lane view. The gallery view shows all assets in a flat grid. The sessions view organises the same assets into temporal lanes, so you can navigate by creative burst rather than by individual image.

When to use lanes

Use the sessions view when:

You want to find a specific creative burst by time period, or review how your work progressed across multiple sessions in a day

Use the gallery view when:

You want to browse all assets regardless of when they were created, or use search and filters to find specific images

Import Compatibility

Sessions work with every import method. The only requirement is that your assets contain generation timestamps in their metadata.

Smart Import

Reads generation timestamps from embedded metadata automatically.

Connected Folders

Watches folders for new assets and extracts timestamps on detection.

Desktop Sync

Syncs assets from your local machine with full metadata preservation.

Manual Upload

Works if the uploaded files contain generation timestamps in their metadata.

What if assets lack timestamps?

Assets without generation timestamps in their metadata cannot be grouped into sessions. They will appear in the gallery as normal but will not be included in session detection. Most AI generation tools (ComfyUI, Midjourney, Stable Diffusion) embed timestamps automatically.

Relive Your Creative Process

Import your AI-generated images and let Numonic organise them into sessions, complete with AI reflections that capture the story behind every creative burst.