-
- Detected:{" "}
-
+
+
+
+ Detected
+
+
{data.capabilities.has_gpu
? `GPU available (${data.capabilities.best_gpu_provider})`
: "No GPU detected — CPU only"}
-
- Currently using:{" "}
-
+
+
+ Currently using
+
+
{data.resolved.using_gpu ? "GPU" : "CPU"}
{data.resolved.notice && (
-
+
{data.resolved.notice}
)}
diff --git a/frontend/src/components/justified-grid.tsx b/frontend/src/components/justified-grid.tsx
index e91c6b7d..625e56de 100644
--- a/frontend/src/components/justified-grid.tsx
+++ b/frontend/src/components/justified-grid.tsx
@@ -42,6 +42,7 @@ interface JustifiedGridProps {
const DEFAULT_TARGET_ROW_HEIGHT = 235;
const DEFAULT_GAP = 8;
const DEFAULT_OVERSCAN_PX = 600;
+const SSR_FALLBACK_WIDTH = 1024;
// Use layout effect in the browser, plain effect during SSR to avoid warnings.
const useIsomorphicLayoutEffect =
@@ -110,7 +111,10 @@ export function JustifiedGrid({
const layout = useMemo(
() =>
computeJustifiedLayout(items, {
- containerWidth,
+ // Render a deterministic first layout during SSR/jsdom instead of an
+ // empty grid. ResizeObserver replaces this with the real width before
+ // paint in normal browsers.
+ containerWidth: containerWidth || SSR_FALLBACK_WIDTH,
targetRowHeight,
gap,
}),
diff --git a/frontend/src/components/map-privacy-settings.tsx b/frontend/src/components/map-privacy-settings.tsx
new file mode 100644
index 00000000..77c998a3
--- /dev/null
+++ b/frontend/src/components/map-privacy-settings.tsx
@@ -0,0 +1,98 @@
+"use client";
+
+import { LockKeyhole, Map as MapIcon, ShieldCheck } from "lucide-react";
+import Link from "next/link";
+
+interface MapPrivacySettingsProps {
+ enabled: boolean | undefined;
+ pending: boolean;
+ onChange: (enabled: boolean) => void;
+}
+
+export function MapPrivacySettings({
+ enabled,
+ pending,
+ onChange,
+}: MapPrivacySettingsProps) {
+ const checked = enabled ?? false;
+
+ return (
+
+
+
+
+
+
+
+ Private photo map
+
+
+ Off by default. When enabled, newly analyzed or reprocessed photos
+ may store GPS coordinates found in their EXIF metadata. Existing
+ photos are unchanged until you reprocess them.
+
+
+
+
+
onChange(!checked)}
+ className="relative h-7 w-12 shrink-0 rounded-full border border-[color:var(--frost-strong)] bg-[color:var(--surface-hover)] transition disabled:cursor-wait disabled:opacity-50 aria-checked:border-[color:var(--orange)] aria-checked:bg-[color:var(--orange)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--blue)] focus-visible:ring-offset-2 focus-visible:ring-offset-[color:var(--void)]"
+ >
+
+
+
+
+
+ The map uses bundled Natural Earth geometry. It never requests
+ online map tiles or reverse geocoding.
+
+
+
+
+
+
+ Hidden, vaulted, deleted, and other users' photos stay off
+ the map.
+
+
+ {checked && (
+
+ Open map
+
+ )}
+
+
+ );
+}
diff --git a/frontend/src/components/map-timeline-panel.tsx b/frontend/src/components/map-timeline-panel.tsx
new file mode 100644
index 00000000..c3b61513
--- /dev/null
+++ b/frontend/src/components/map-timeline-panel.tsx
@@ -0,0 +1,122 @@
+"use client";
+
+import { CalendarDays, Images, X } from "lucide-react";
+import { useMemo, useState } from "react";
+import { AssetViewer } from "@/components/asset-viewer";
+import type { MapMarker } from "@/lib/api";
+import { groupMediaByMonth } from "@/lib/media-timeline";
+import type { ViewerAsset } from "@/lib/viewer-preload";
+
+interface MapTimelinePanelProps {
+ markers: MapMarker[];
+ onClose: () => void;
+}
+
+export function MapTimelinePanel({ markers, onClose }: MapTimelinePanelProps) {
+ const [viewerIndex, setViewerIndex] = useState(null);
+ const groups = useMemo(
+ () => groupMediaByMonth(markers, (marker) => marker.created_at),
+ [markers],
+ );
+ const timelineMarkers = useMemo(
+ () => groups.flatMap((group) => group.items),
+ [groups],
+ );
+ const viewerAssets = useMemo(
+ () =>
+ timelineMarkers.map((marker) => ({
+ id: marker.id,
+ thumbnailUrl: marker.thumbnail_url,
+ originalUrl: `/api/image/${marker.id}/original`,
+ alt: marker.filename,
+ })),
+ [timelineMarkers],
+ );
+
+ let runningIndex = 0;
+
+ return (
+ <>
+
+
+ {viewerIndex !== null && viewerAssets[viewerIndex] && (
+ setViewerIndex(null)}
+ />
+ )}
+
+ );
+}
diff --git a/frontend/src/components/private-map.module.css b/frontend/src/components/private-map.module.css
new file mode 100644
index 00000000..e8128470
--- /dev/null
+++ b/frontend/src/components/private-map.module.css
@@ -0,0 +1,104 @@
+.shell {
+ position: relative;
+ min-height: 34rem;
+ height: min(72dvh, 54rem);
+ overflow: hidden;
+ border: 1px solid var(--frost);
+ border-radius: 1.25rem;
+ background: #09131d;
+ box-shadow: 0 20px 70px rgb(0 0 0 / 24%);
+}
+
+.canvas {
+ position: absolute;
+ inset: 0;
+}
+
+.status {
+ position: absolute;
+ z-index: 2;
+ right: 0.75rem;
+ bottom: 0.75rem;
+ display: flex;
+ align-items: center;
+ gap: 0.4rem;
+ max-width: calc(100% - 1.5rem);
+ border: 1px solid rgb(255 255 255 / 14%);
+ border-radius: 999px;
+ background: rgb(3 9 15 / 78%);
+ padding: 0.45rem 0.7rem;
+ color: #dceeff;
+ font-size: 0.7rem;
+ line-height: 1;
+ pointer-events: none;
+ backdrop-filter: blur(14px);
+}
+
+.photoMarker,
+.clusterMarker {
+ display: grid;
+ place-items: center;
+ border: 2px solid #ff801f;
+ border-radius: 999px;
+ padding: 0;
+ color: #fff;
+ cursor: pointer;
+ box-shadow:
+ 0 8px 24px rgb(0 0 0 / 42%),
+ 0 0 0 4px rgb(255 128 31 / 18%);
+ transition:
+ transform 140ms ease,
+ border-color 140ms ease,
+ box-shadow 140ms ease;
+}
+
+.photoMarker {
+ width: 2.9rem;
+ height: 2.9rem;
+ overflow: hidden;
+ background: #162534;
+}
+
+.photoMarker img {
+ width: 100%;
+ height: 100%;
+ object-fit: cover;
+}
+
+.clusterMarker {
+ min-width: 2.9rem;
+ height: 2.9rem;
+ background: linear-gradient(145deg, #ff9a4c, #f15f00);
+ padding-inline: 0.65rem;
+ font-size: 0.78rem;
+ font-weight: 800;
+ font-variant-numeric: tabular-nums;
+}
+
+.photoMarker:hover,
+.photoMarker:focus-visible,
+.clusterMarker:hover,
+.clusterMarker:focus-visible {
+ z-index: 2;
+ border-color: #fff;
+ outline: none;
+ transform: scale(1.12);
+ box-shadow:
+ 0 12px 30px rgb(0 0 0 / 55%),
+ 0 0 0 5px rgb(255 255 255 / 22%);
+}
+
+.photoMarker[data-selected="true"] {
+ border-color: #fff;
+ box-shadow:
+ 0 12px 30px rgb(0 0 0 / 55%),
+ 0 0 0 6px rgb(255 128 31 / 44%);
+}
+
+@media (max-width: 760px) {
+ .shell {
+ min-height: 28rem;
+ height: 58dvh;
+ border-radius: 1rem;
+ }
+}
diff --git a/frontend/src/components/private-map.tsx b/frontend/src/components/private-map.tsx
new file mode 100644
index 00000000..0b4dcd94
--- /dev/null
+++ b/frontend/src/components/private-map.tsx
@@ -0,0 +1,522 @@
+"use client";
+
+import "maplibre-gl/dist/maplibre-gl.css";
+
+import type {
+ GeoJSONSource,
+ Map as MapLibreMap,
+ Marker as MapLibreMarker,
+ StyleSpecification,
+} from "maplibre-gl";
+import { useEffect, useRef } from "react";
+import type { MapMarker } from "@/lib/api";
+import styles from "./private-map.module.css";
+
+const LAND_SOURCE_URL = "/maps/ne_110m_land.geojson";
+const PHOTO_SOURCE_ID = "private-photos";
+const CLUSTER_LAYER_ID = "private-photo-clusters";
+const PHOTO_LAYER_ID = "private-photo-points";
+
+interface PrivateMapProps {
+ markers: MapMarker[];
+ selectedIds: ReadonlySet;
+ onSelect: (ids: number[]) => void;
+ fitRequest: number;
+}
+
+type MapLibreModule = typeof import("maplibre-gl");
+
+interface RenderedDomMarker {
+ marker: MapLibreMarker;
+ element: HTMLButtonElement;
+}
+
+export function mapMarkersToFeatureCollection(markers: readonly MapMarker[]) {
+ return {
+ type: "FeatureCollection" as const,
+ features: markers.map((marker) => ({
+ type: "Feature" as const,
+ geometry: {
+ type: "Point" as const,
+ coordinates: [marker.lon, marker.lat],
+ },
+ properties: {
+ id: marker.id,
+ },
+ })),
+ };
+}
+
+function isDarkMap(): boolean {
+ const root = document.documentElement;
+ if (root.dataset.theme === "light" || root.classList.contains("light")) {
+ return false;
+ }
+ if (root.dataset.theme === "dark" || root.classList.contains("dark")) {
+ return true;
+ }
+ return window.matchMedia?.("(prefers-color-scheme: dark)").matches ?? true;
+}
+
+export function buildOfflineMapStyle(
+ markers: readonly MapMarker[],
+ dark: boolean,
+): StyleSpecification {
+ return {
+ version: 8,
+ sources: {
+ "offline-land": {
+ type: "geojson",
+ data: LAND_SOURCE_URL,
+ },
+ [PHOTO_SOURCE_ID]: {
+ type: "geojson",
+ data: mapMarkersToFeatureCollection(markers),
+ cluster: true,
+ clusterMaxZoom: 14,
+ clusterRadius: 48,
+ },
+ },
+ layers: [
+ {
+ id: "offline-ocean",
+ type: "background",
+ paint: {
+ "background-color": dark ? "#07121c" : "#dbeaf1",
+ },
+ },
+ {
+ id: "offline-land-fill",
+ type: "fill",
+ source: "offline-land",
+ paint: {
+ "fill-color": dark ? "#172a36" : "#f4efe5",
+ "fill-opacity": 1,
+ },
+ },
+ {
+ id: "offline-land-line",
+ type: "line",
+ source: "offline-land",
+ paint: {
+ "line-color": dark ? "#355262" : "#b9c5c8",
+ "line-width": 0.75,
+ "line-opacity": 0.8,
+ },
+ },
+ {
+ id: CLUSTER_LAYER_ID,
+ type: "circle",
+ source: PHOTO_SOURCE_ID,
+ filter: ["has", "point_count"],
+ paint: {
+ "circle-color": "#ff801f",
+ "circle-radius": [
+ "step",
+ ["get", "point_count"],
+ 20,
+ 10,
+ 23,
+ 100,
+ 27,
+ ],
+ "circle-opacity": 0.28,
+ "circle-stroke-color": "#ffb77e",
+ "circle-stroke-width": 1,
+ },
+ },
+ {
+ id: PHOTO_LAYER_ID,
+ type: "circle",
+ source: PHOTO_SOURCE_ID,
+ filter: ["!", ["has", "point_count"]],
+ paint: {
+ "circle-color": "#ff801f",
+ "circle-radius": 18,
+ "circle-opacity": 0.2,
+ "circle-stroke-color": "#ffb77e",
+ "circle-stroke-width": 1,
+ },
+ },
+ ],
+ };
+}
+
+/** Return the smallest longitude interval, including across the dateline. */
+export function calculateMapBounds(
+ markers: readonly MapMarker[],
+): [west: number, south: number, east: number, north: number] | null {
+ if (markers.length === 0) {
+ return null;
+ }
+
+ const longitudes = markers
+ .map((marker) => ((marker.lon % 360) + 360) % 360)
+ .sort((left, right) => left - right);
+ let largestGap = -1;
+ let gapStartIndex = 0;
+ for (let index = 0; index < longitudes.length; index += 1) {
+ const current = longitudes[index];
+ const next =
+ index === longitudes.length - 1
+ ? (longitudes[0] ?? 0) + 360
+ : longitudes[index + 1];
+ if (current === undefined || next === undefined) {
+ continue;
+ }
+ const gap = next - current;
+ if (gap > largestGap) {
+ largestGap = gap;
+ gapStartIndex = index;
+ }
+ }
+
+ const westIndex = (gapStartIndex + 1) % longitudes.length;
+ let west = longitudes[westIndex] ?? markers[0]?.lon ?? 0;
+ let east = longitudes[gapStartIndex] ?? west;
+ if (east < west) {
+ east += 360;
+ }
+ if (west > 180) {
+ west -= 360;
+ east -= 360;
+ }
+
+ const latitudes = markers.map((marker) => marker.lat);
+ return [west, Math.min(...latitudes), east, Math.max(...latitudes)];
+}
+
+function fitMarkers(
+ map: MapLibreMap,
+ maplibre: MapLibreModule,
+ markers: readonly MapMarker[],
+): void {
+ if (markers.length === 0) {
+ map.easeTo({ center: [15, 20], zoom: 1.25, duration: 350 });
+ return;
+ }
+
+ const first = markers[0];
+ if (!first) {
+ return;
+ }
+ if (markers.length === 1) {
+ map.easeTo({
+ center: [first.lon, first.lat],
+ zoom: 10,
+ duration: 450,
+ });
+ return;
+ }
+
+ const coordinates = calculateMapBounds(markers);
+ if (!coordinates) {
+ return;
+ }
+ const [west, south, east, north] = coordinates;
+ const bounds = new maplibre.LngLatBounds([west, south], [east, north]);
+ map.fitBounds(bounds, {
+ padding: 64,
+ maxZoom: 11,
+ duration: 500,
+ });
+}
+
+function applyMapPalette(map: MapLibreMap): void {
+ if (!map.isStyleLoaded()) {
+ return;
+ }
+ const dark = isDarkMap();
+ map.setPaintProperty(
+ "offline-ocean",
+ "background-color",
+ dark ? "#07121c" : "#dbeaf1",
+ );
+ map.setPaintProperty(
+ "offline-land-fill",
+ "fill-color",
+ dark ? "#172a36" : "#f4efe5",
+ );
+ map.setPaintProperty(
+ "offline-land-line",
+ "line-color",
+ dark ? "#355262" : "#b9c5c8",
+ );
+}
+
+export function PrivateMap({
+ markers,
+ selectedIds,
+ onSelect,
+ fitRequest,
+}: PrivateMapProps) {
+ const containerRef = useRef(null);
+ const mapRef = useRef(null);
+ const maplibreRef = useRef(null);
+ const markersRef = useRef(markers);
+ const selectedIdsRef = useRef(selectedIds);
+ const onSelectRef = useRef(onSelect);
+ const syncMarkersRef = useRef<() => void>(() => {});
+ const lastFitRequestRef = useRef(fitRequest);
+
+ markersRef.current = markers;
+ selectedIdsRef.current = selectedIds;
+ onSelectRef.current = onSelect;
+
+ useEffect(() => {
+ const container = containerRef.current;
+ if (!container) {
+ return;
+ }
+
+ let disposed = false;
+ let themeObserver: MutationObserver | null = null;
+ let resizeObserver: ResizeObserver | null = null;
+ const rendered = new Map();
+
+ void import("maplibre-gl").then((maplibre) => {
+ if (disposed || !containerRef.current) {
+ return;
+ }
+
+ maplibreRef.current = maplibre;
+ const map = new maplibre.Map({
+ container: containerRef.current,
+ style: buildOfflineMapStyle(markersRef.current, isDarkMap()),
+ center: [15, 20],
+ zoom: 1.25,
+ minZoom: 0.75,
+ maxZoom: 18,
+ renderWorldCopies: false,
+ attributionControl: false,
+ });
+ mapRef.current = map;
+ map.addControl(
+ new maplibre.NavigationControl({ showCompass: false }),
+ "top-left",
+ );
+
+ const chooseCluster = async (clusterId: number) => {
+ const source = map.getSource(PHOTO_SOURCE_ID) as
+ | GeoJSONSource
+ | undefined;
+ if (!source) {
+ return;
+ }
+ const leaves = await source.getClusterLeaves(clusterId, 10_000, 0);
+ const ids = leaves
+ .map((leaf) => Number(leaf.properties?.id))
+ .filter((id) => Number.isFinite(id));
+ if (ids.length === 0) {
+ return;
+ }
+ onSelectRef.current(ids);
+ const idSet = new Set(ids);
+ fitMarkers(
+ map,
+ maplibre,
+ markersRef.current.filter((marker) => idSet.has(marker.id)),
+ );
+ };
+
+ const syncMarkers = () => {
+ if (
+ !map.isStyleLoaded() ||
+ !map.getLayer(CLUSTER_LAYER_ID) ||
+ !map.getLayer(PHOTO_LAYER_ID)
+ ) {
+ return;
+ }
+
+ const visibleKeys = new Set();
+ const clusterFeatures = map.queryRenderedFeatures({
+ layers: [CLUSTER_LAYER_ID],
+ });
+ for (const feature of clusterFeatures) {
+ if (feature.geometry.type !== "Point") {
+ continue;
+ }
+ const clusterId = Number(feature.properties?.cluster_id);
+ const count = Number(feature.properties?.point_count);
+ if (!Number.isFinite(clusterId) || !Number.isFinite(count)) {
+ continue;
+ }
+ const key = `cluster-${clusterId}`;
+ if (visibleKeys.has(key)) {
+ continue;
+ }
+ visibleKeys.add(key);
+ const coordinates = feature.geometry.coordinates as [number, number];
+ const current = rendered.get(key);
+ if (current) {
+ current.marker.setLngLat(coordinates);
+ current.element.textContent = count.toLocaleString();
+ continue;
+ }
+
+ const element = document.createElement("button");
+ element.type = "button";
+ element.className = styles.clusterMarker ?? "";
+ element.textContent = count.toLocaleString();
+ element.setAttribute(
+ "aria-label",
+ `${count.toLocaleString()} photos in this area`,
+ );
+ element.addEventListener("click", (event) => {
+ event.preventDefault();
+ event.stopPropagation();
+ void chooseCluster(clusterId);
+ });
+ rendered.set(key, {
+ marker: new maplibre.Marker({ element })
+ .setLngLat(coordinates)
+ .addTo(map),
+ element,
+ });
+ }
+
+ const markerById = new Map(
+ markersRef.current.map((marker) => [marker.id, marker]),
+ );
+ const photoFeatures = map.queryRenderedFeatures({
+ layers: [PHOTO_LAYER_ID],
+ });
+ for (const feature of photoFeatures) {
+ if (feature.geometry.type !== "Point") {
+ continue;
+ }
+ const id = Number(feature.properties?.id);
+ const photo = markerById.get(id);
+ if (!photo) {
+ continue;
+ }
+ const key = `photo-${id}`;
+ if (visibleKeys.has(key)) {
+ continue;
+ }
+ visibleKeys.add(key);
+ const coordinates = feature.geometry.coordinates as [number, number];
+ const current = rendered.get(key);
+ if (current) {
+ current.marker.setLngLat(coordinates);
+ current.element.dataset.selected = String(
+ selectedIdsRef.current.has(id),
+ );
+ continue;
+ }
+
+ const element = document.createElement("button");
+ element.type = "button";
+ element.className = styles.photoMarker ?? "";
+ element.dataset.selected = String(selectedIdsRef.current.has(id));
+ element.setAttribute(
+ "aria-label",
+ `Show ${photo.filename} on timeline`,
+ );
+
+ const image = document.createElement("img");
+ image.src = photo.thumbnail_url;
+ image.alt = "";
+ image.loading = "lazy";
+ element.append(image);
+ element.addEventListener("click", (event) => {
+ event.preventDefault();
+ event.stopPropagation();
+ onSelectRef.current([id]);
+ });
+ rendered.set(key, {
+ marker: new maplibre.Marker({ element })
+ .setLngLat(coordinates)
+ .addTo(map),
+ element,
+ });
+ }
+
+ for (const [key, entry] of rendered) {
+ if (!visibleKeys.has(key)) {
+ entry.marker.remove();
+ rendered.delete(key);
+ }
+ }
+ };
+ syncMarkersRef.current = syncMarkers;
+
+ map.on("load", () => {
+ const source = map.getSource(PHOTO_SOURCE_ID) as
+ | GeoJSONSource
+ | undefined;
+ source?.setData(mapMarkersToFeatureCollection(markersRef.current));
+ applyMapPalette(map);
+ fitMarkers(map, maplibre, markersRef.current);
+ syncMarkers();
+ });
+ map.on("idle", syncMarkers);
+ map.on("moveend", syncMarkers);
+ map.on("zoomend", syncMarkers);
+
+ themeObserver = new MutationObserver(() => applyMapPalette(map));
+ themeObserver.observe(document.documentElement, {
+ attributes: true,
+ attributeFilter: ["class", "data-theme"],
+ });
+
+ resizeObserver = new ResizeObserver(() => map.resize());
+ resizeObserver.observe(container);
+ });
+
+ return () => {
+ disposed = true;
+ themeObserver?.disconnect();
+ resizeObserver?.disconnect();
+ syncMarkersRef.current = () => {};
+ for (const entry of rendered.values()) {
+ entry.marker.remove();
+ }
+ rendered.clear();
+ mapRef.current?.remove();
+ mapRef.current = null;
+ maplibreRef.current = null;
+ };
+ }, []);
+
+ useEffect(() => {
+ const map = mapRef.current;
+ const maplibre = maplibreRef.current;
+ if (!map || !maplibre || !map.isStyleLoaded()) {
+ return;
+ }
+ const source = map.getSource(PHOTO_SOURCE_ID) as GeoJSONSource | undefined;
+ source?.setData(mapMarkersToFeatureCollection(markers));
+ map.once("idle", () => {
+ syncMarkersRef.current();
+ fitMarkers(map, maplibre, markers);
+ });
+ }, [markers]);
+
+ useEffect(() => {
+ selectedIdsRef.current = selectedIds;
+ syncMarkersRef.current();
+ }, [selectedIds]);
+
+ useEffect(() => {
+ if (lastFitRequestRef.current === fitRequest) {
+ return;
+ }
+ lastFitRequestRef.current = fitRequest;
+ const map = mapRef.current;
+ const maplibre = maplibreRef.current;
+ if (map && maplibre) {
+ fitMarkers(map, maplibre, markersRef.current);
+ }
+ }, [fitRequest]);
+
+ return (
+
+
+
+ ●
+ Local Natural Earth map · no tile or geocoding requests
+
+
+ );
+}
diff --git a/frontend/src/components/timeline-media-view.tsx b/frontend/src/components/timeline-media-view.tsx
new file mode 100644
index 00000000..a8cc2404
--- /dev/null
+++ b/frontend/src/components/timeline-media-view.tsx
@@ -0,0 +1,397 @@
+"use client";
+
+/**
+ * Route-agnostic, date-grouped media timeline.
+ *
+ * Its month sections, justified rows, fast date scrubber, and scroll-position
+ * mapping are adapted from the AGPL-3.0 reference project's timeline behavior.
+ * Original copyright belongs to its authors. This file is part of Find and is
+ * distributed under AGPL-3.0. See NOTICE.
+ */
+
+import {
+ type ReactNode,
+ type RefObject,
+ useCallback,
+ useEffect,
+ useMemo,
+ useRef,
+ useState,
+} from "react";
+import { AssetViewer } from "@/components/asset-viewer";
+import { JustifiedGrid } from "@/components/justified-grid";
+import { TimelineScrubber } from "@/components/timeline-scrubber";
+import {
+ actualOffsetToScrubberOffset,
+ groupMediaByMonth,
+ mediaAspectRatio,
+ scrubberOffsetToActualOffset,
+ type TimelineSectionMeasurement,
+ timelineBucketsFromGroups,
+} from "@/lib/media-timeline";
+import {
+ buildScrubberLayout,
+ type ScrubberOptions,
+} from "@/lib/timeline-scrubber";
+import type { ViewerAsset } from "@/lib/viewer-preload";
+
+const SCROLL_ANCHOR_PX = 96;
+
+export interface TimelineMediaViewerRenderProps {
+ items: T[];
+ viewerAssets: ViewerAsset[];
+ index: number;
+ onIndexChange: (index: number) => void;
+ onClose: () => void;
+}
+
+interface TimelineMediaViewProps {
+ items: readonly T[];
+ getId: (item: T) => number;
+ getDate: (item: T) => string | null | undefined;
+ getWidth?: (item: T) => number | null | undefined;
+ getHeight?: (item: T) => number | null | undefined;
+ getThumbnailUrl: (item: T) => string | null | undefined;
+ getOriginalUrl: (item: T) => string | null | undefined;
+ getAlt?: (item: T) => string;
+ getOpenLabel?: (item: T) => string;
+ getItemTestId?: (item: T) => string;
+ getOpenTestId?: (item: T) => string;
+ onOpenItem?: (item: T, index: number) => void;
+ renderItemActions?: (item: T) => ReactNode;
+ renderViewer?: (props: TimelineMediaViewerRenderProps) => ReactNode;
+ order?: "newest" | "oldest";
+ empty?: ReactNode;
+ className?: string;
+ controlsId?: string;
+ scrollContainerRef?: RefObject;
+}
+
+function useResponsiveRowHeight(): number {
+ const [rowHeight, setRowHeight] = useState(220);
+
+ useEffect(() => {
+ const update = () => setRowHeight(window.innerWidth < 768 ? 120 : 220);
+ update();
+ window.addEventListener("resize", update);
+ return () => window.removeEventListener("resize", update);
+ }, []);
+
+ return rowHeight;
+}
+
+export function TimelineMediaView({
+ items,
+ getId,
+ getDate,
+ getWidth = () => null,
+ getHeight = () => null,
+ getThumbnailUrl,
+ getOriginalUrl,
+ getAlt = () => "",
+ getOpenLabel,
+ getItemTestId,
+ getOpenTestId,
+ onOpenItem,
+ renderItemActions,
+ renderViewer,
+ order = "newest",
+ empty,
+ className,
+ controlsId = "route-media-timeline",
+ scrollContainerRef,
+}: TimelineMediaViewProps) {
+ const rootRef = useRef(null);
+ const sectionRefs = useRef(new Map());
+ const [scrollOffset, setScrollOffset] = useState(0);
+ const [viewerIndex, setViewerIndex] = useState(null);
+ const targetRowHeight = useResponsiveRowHeight();
+
+ const groups = useMemo(
+ () => groupMediaByMonth(items, getDate, order),
+ [getDate, items, order],
+ );
+ const timelineItems = useMemo(
+ () => groups.flatMap((group) => group.items),
+ [groups],
+ );
+ const buckets = useMemo(() => timelineBucketsFromGroups(groups), [groups]);
+ const layoutOptions = useMemo(
+ () => ({
+ columnsPerRow: targetRowHeight <= 120 ? 3 : 5,
+ gap: 6,
+ headerHeight: 44,
+ targetRowHeight,
+ }),
+ [targetRowHeight],
+ );
+ const scrubberLayout = useMemo(
+ () => buildScrubberLayout(buckets, layoutOptions),
+ [buckets, layoutOptions],
+ );
+
+ const viewerAssets = useMemo(
+ () =>
+ timelineItems.map((item) => {
+ const thumbnailUrl = getThumbnailUrl(item) ?? "";
+ return {
+ id: getId(item),
+ thumbnailUrl,
+ alt: getAlt(item),
+ // View-only shares deliberately fall back to their share-scoped
+ // thumbnail; a private route is never synthesized here.
+ originalUrl: getOriginalUrl(item) ?? thumbnailUrl,
+ };
+ }),
+ [getAlt, getId, getOriginalUrl, getThumbnailUrl, timelineItems],
+ );
+
+ const measurements = useCallback((): TimelineSectionMeasurement[] => {
+ const root = rootRef.current;
+ if (!root || typeof window === "undefined") {
+ return [];
+ }
+
+ const rootTop = root.getBoundingClientRect().top;
+ return groups.flatMap((group) => {
+ const section = sectionRefs.current.get(group.timeBucket);
+ if (!section) {
+ return [];
+ }
+ const rect = section.getBoundingClientRect();
+ return [
+ {
+ timeBucket: group.timeBucket,
+ top: rect.top - rootTop,
+ height: Math.max(rect.height, section.offsetHeight),
+ },
+ ];
+ });
+ }, [groups]);
+
+ useEffect(() => {
+ if (typeof window === "undefined") {
+ return;
+ }
+
+ const update = () => {
+ const root = rootRef.current;
+ if (!root) {
+ return;
+ }
+ const container = scrollContainerRef?.current;
+ const rootTop = container
+ ? root.getBoundingClientRect().top -
+ container.getBoundingClientRect().top +
+ container.scrollTop
+ : root.getBoundingClientRect().top + window.scrollY;
+ const scrollPosition = container?.scrollTop ?? window.scrollY;
+ const actualOffset = scrollPosition + SCROLL_ANCHOR_PX - rootTop;
+ setScrollOffset(
+ actualOffsetToScrubberOffset(
+ measurements(),
+ scrubberLayout,
+ actualOffset,
+ ),
+ );
+ };
+
+ const scrollTarget = scrollContainerRef?.current ?? window;
+ update();
+ scrollTarget.addEventListener("scroll", update, { passive: true });
+ window.addEventListener("resize", update);
+ return () => {
+ scrollTarget.removeEventListener("scroll", update);
+ window.removeEventListener("resize", update);
+ };
+ }, [measurements, scrollContainerRef, scrubberLayout]);
+
+ useEffect(() => {
+ if (
+ viewerIndex !== null &&
+ (viewerIndex < 0 || viewerIndex >= timelineItems.length)
+ ) {
+ setViewerIndex(null);
+ }
+ }, [timelineItems.length, viewerIndex]);
+
+ const handleScrub = useCallback(
+ (nextOffset: number) => {
+ const root = rootRef.current;
+ if (!root || typeof window === "undefined") {
+ return;
+ }
+
+ const actualOffset = scrubberOffsetToActualOffset(
+ measurements(),
+ scrubberLayout,
+ nextOffset,
+ );
+ const container = scrollContainerRef?.current;
+ const rootTop = container
+ ? root.getBoundingClientRect().top -
+ container.getBoundingClientRect().top +
+ container.scrollTop
+ : root.getBoundingClientRect().top + window.scrollY;
+ setScrollOffset(nextOffset);
+ const top = Math.max(0, rootTop + actualOffset - SCROLL_ANCHOR_PX);
+ if (container) container.scrollTo({ top, behavior: "auto" });
+ else window.scrollTo({ top, behavior: "auto" });
+ },
+ [measurements, scrollContainerRef, scrubberLayout],
+ );
+
+ if (timelineItems.length === 0) {
+ return <>{empty};
+ }
+
+ let runningIndex = 0;
+
+ return (
+ <>
+
+
+ {groups.map((group) => {
+ const groupStartIndex = runningIndex;
+ runningIndex += group.items.length;
+
+ return (
+
{
+ if (element) {
+ sectionRefs.current.set(group.timeBucket, element);
+ } else {
+ sectionRefs.current.delete(group.timeBucket);
+ }
+ }}
+ data-testid={`timeline-group-${group.timeBucket}`}
+ aria-labelledby={`timeline-heading-${group.timeBucket}`}
+ style={{ marginBottom: 28, scrollMarginTop: SCROLL_ANCHOR_PX }}
+ >
+
+ {group.label}
+
+ {group.items.length}
+
+
+ ({
+ item,
+ ratio: mediaAspectRatio(getWidth(item), getHeight(item)),
+ }))}
+ targetRowHeight={targetRowHeight}
+ gap={6}
+ getKey={({ item }) => getId(item)}
+ renderItem={({ item }, index) => {
+ const timelineIndex = groupStartIndex + index;
+ const thumbnailUrl = getThumbnailUrl(item);
+ return (
+
+ {
+ if (onOpenItem) onOpenItem(item, timelineIndex);
+ else setViewerIndex(timelineIndex);
+ }}
+ className="block h-full w-full focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--blue)] focus-visible:ring-inset"
+ >
+ {thumbnailUrl ? (
+ // biome-ignore lint/performance/noImgElement: authenticated and share-scoped media URLs are not Next image assets.
+
+ No preview
+
+ )}
+
+ {renderItemActions && (
+
+ {renderItemActions(item)}
+
+ )}
+
+ );
+ }}
+ />
+
+ );
+ })}
+
+
+
+
setViewerIndex(null)}
+ />
+ ))}
+
+ );
+}
diff --git a/frontend/src/components/vault/VaultGallery.tsx b/frontend/src/components/vault/VaultGallery.tsx
index f79552b2..4a9a9e16 100644
--- a/frontend/src/components/vault/VaultGallery.tsx
+++ b/frontend/src/components/vault/VaultGallery.tsx
@@ -1,138 +1,292 @@
"use client";
-import { useQuery } from "@tanstack/react-query";
-import axios from "axios";
-import { ImageOff, Loader2, Lock } from "lucide-react";
-import { useEffect, useRef, useState } from "react";
-import { api } from "@/lib/api";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { ImageOff, Loader2, Lock, RotateCcw } from "lucide-react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { AssetViewer } from "@/components/asset-viewer";
+import {
+ TimelineMediaView,
+ type TimelineMediaViewerRenderProps,
+} from "@/components/timeline-media-view";
import { vaultStore } from "@/store/vaultStore";
import { VaultUnlock } from "./VaultUnlock";
+import {
+ fetchVaultOriginal,
+ fetchVaultThumbnail,
+ isExpiredVaultSession,
+ listVaultItems,
+ lockVaultSession,
+ restoreVaultItem,
+ type VaultListItem,
+} from "./vault-client";
-type VaultListItem = {
- id: number;
- filename: string;
- content_type: string | null;
- created_at: string | null;
-};
+const VAULT_QUERY_KEY = ["vault-gallery"] as const;
+const THUMBNAIL_CONCURRENCY = 3;
+
+interface VaultViewerProps
+ extends TimelineMediaViewerRenderProps {
+ sessionToken: string;
+ thumbnailUrls: Readonly>;
+ onSessionExpired: () => void;
+ onLoadError: () => void;
+}
+
+function VaultViewer({
+ items,
+ index,
+ onIndexChange,
+ onClose,
+ sessionToken,
+ thumbnailUrls,
+ onSessionExpired,
+ onLoadError,
+}: VaultViewerProps) {
+ const activeId = items[index]?.id;
+ const [original, setOriginal] = useState<{
+ mediaId: number;
+ url: string;
+ } | null>(null);
+ const handlersRef = useRef({ onClose, onSessionExpired, onLoadError });
+
+ useEffect(() => {
+ handlersRef.current = { onClose, onSessionExpired, onLoadError };
+ }, [onClose, onLoadError, onSessionExpired]);
+
+ useEffect(() => {
+ if (!activeId) {
+ return;
+ }
+
+ let cancelled = false;
+ let objectUrl: string | null = null;
+ setOriginal(null);
+
+ void fetchVaultOriginal(activeId, sessionToken)
+ .then((blob) => {
+ if (cancelled) {
+ return;
+ }
+ objectUrl = URL.createObjectURL(blob);
+ setOriginal({ mediaId: activeId, url: objectUrl });
+ })
+ .catch((error: unknown) => {
+ if (cancelled) {
+ return;
+ }
+ if (isExpiredVaultSession(error)) {
+ handlersRef.current.onClose();
+ handlersRef.current.onSessionExpired();
+ return;
+ }
+ handlersRef.current.onLoadError();
+ });
+
+ return () => {
+ cancelled = true;
+ if (objectUrl) {
+ URL.revokeObjectURL(objectUrl);
+ }
+ };
+ }, [activeId, sessionToken]);
+
+ const assets = useMemo(
+ () =>
+ items.map((item) => {
+ const thumbnailUrl = thumbnailUrls[item.id] ?? "";
+ return {
+ id: item.id,
+ thumbnailUrl,
+ originalUrl:
+ original?.mediaId === item.id ? original.url : thumbnailUrl,
+ };
+ }),
+ [items, original, thumbnailUrls],
+ );
+
+ return (
+ (null);
- const [streamUrls, setStreamUrls] = useState>({});
+ const [thumbnailUrls, setThumbnailUrls] = useState>(
+ {},
+ );
const objectUrlsRef = useRef>({});
+ const revokeThumbnails = useCallback(() => {
+ for (const url of Object.values(objectUrlsRef.current)) {
+ URL.revokeObjectURL(url);
+ }
+ objectUrlsRef.current = {};
+ setThumbnailUrls({});
+ }, []);
+
+ const clearSession = useCallback(
+ (message: string) => {
+ revokeThumbnails();
+ queryClient.removeQueries({ queryKey: VAULT_QUERY_KEY });
+ vaultStore.getState().lock();
+ setSessionMessage(message);
+ },
+ [queryClient, revokeThumbnails],
+ );
+
const listQuery = useQuery({
- queryKey: ["vault-gallery", sessionToken],
+ queryKey: VAULT_QUERY_KEY,
enabled: isUnlocked && !!sessionToken,
- queryFn: async () => {
- const response = await api.get("/api/vault/list", {
- headers: {
- Authorization: `Bearer ${sessionToken}`,
- },
- });
- return response.data;
- },
+ queryFn: () => listVaultItems(sessionToken ?? ""),
});
useEffect(() => {
- if (!listQuery.error || !axios.isAxiosError(listQuery.error)) {
+ if (!listQuery.error) {
return;
}
- if (listQuery.error.response?.status === 401) {
- vaultStore.getState().lock();
- setSessionMessage("Session expired. Please unlock again.");
+ if (isExpiredVaultSession(listQuery.error)) {
+ clearSession("Session expired. Please unlock again.");
}
- }, [listQuery.error]);
+ }, [clearSession, listQuery.error]);
useEffect(() => {
if (!isUnlocked) {
- Object.values(objectUrlsRef.current).forEach((url) => {
- URL.revokeObjectURL(url);
- });
- objectUrlsRef.current = {};
- setStreamUrls({});
+ revokeThumbnails();
return;
}
-
setSessionMessage(null);
- }, [isUnlocked]);
+ }, [isUnlocked, revokeThumbnails]);
useEffect(() => {
- if (!isUnlocked || !sessionToken || !listQuery.data) {
+ const items = listQuery.data;
+ if (!isUnlocked || !sessionToken || !items) {
return;
}
- let cancelled = false;
+ const currentIds = new Set(items.map((item) => item.id));
+ for (const [rawId, url] of Object.entries(objectUrlsRef.current)) {
+ const mediaId = Number(rawId);
+ if (!currentIds.has(mediaId)) {
+ URL.revokeObjectURL(url);
+ delete objectUrlsRef.current[mediaId];
+ }
+ }
+ setThumbnailUrls({ ...objectUrlsRef.current });
- const loadStreams = async () => {
- const nextUrls: Record = {};
-
- try {
- await Promise.all(
- listQuery.data.map(async (item) => {
- const response = await api.get(
- `/api/vault/stream/${item.id}`,
- {
- headers: {
- Authorization: `Bearer ${sessionToken}`,
- },
- responseType: "blob",
- },
- );
-
- if (!cancelled) {
- nextUrls[item.id] = URL.createObjectURL(response.data);
- }
- }),
- );
+ const queue = items.filter((item) => !objectUrlsRef.current[item.id]);
+ let cursor = 0;
+ let cancelled = false;
- if (cancelled) {
- Object.values(nextUrls).forEach((url) => {
- URL.revokeObjectURL(url);
- });
+ const worker = async () => {
+ while (!cancelled) {
+ const item = queue[cursor];
+ cursor += 1;
+ if (!item) {
return;
}
- Object.values(objectUrlsRef.current).forEach((url) => {
- URL.revokeObjectURL(url);
- });
- objectUrlsRef.current = nextUrls;
- setStreamUrls(nextUrls);
- } catch (error) {
- Object.values(nextUrls).forEach((url) => {
- URL.revokeObjectURL(url);
- });
-
- if (axios.isAxiosError(error) && error.response?.status === 401) {
- vaultStore.getState().lock();
- setSessionMessage("Session expired. Please unlock again.");
- } else {
+ try {
+ const blob = await fetchVaultThumbnail(item.id, sessionToken);
+ if (cancelled) {
+ return;
+ }
+ const url = URL.createObjectURL(blob);
+ objectUrlsRef.current[item.id] = url;
+ setThumbnailUrls((current) => ({ ...current, [item.id]: url }));
+ } catch (error) {
+ if (cancelled) {
+ return;
+ }
+ if (isExpiredVaultSession(error)) {
+ cancelled = true;
+ clearSession("Session expired. Please unlock again.");
+ return;
+ }
setSessionMessage(
- "Some images could not be decrypted. Please try again.",
+ "Some encrypted previews could not be loaded. You can retry shortly.",
);
}
}
};
- void loadStreams();
+ const workers = Array.from(
+ { length: Math.min(THUMBNAIL_CONCURRENCY, queue.length) },
+ () => worker(),
+ );
+ void Promise.all(workers);
return () => {
cancelled = true;
};
- }, [isUnlocked, listQuery.data, sessionToken]);
+ }, [clearSession, isUnlocked, listQuery.data, sessionToken]);
- useEffect(() => {
- return () => {
- Object.values(objectUrlsRef.current).forEach((url) => {
- URL.revokeObjectURL(url);
+ useEffect(() => revokeThumbnails, [revokeThumbnails]);
+
+ const restoreMutation = useMutation({
+ mutationFn: async (mediaId: number) => {
+ if (!sessionToken) {
+ throw new Error("Vault session missing");
+ }
+ await restoreVaultItem(mediaId, sessionToken);
+ return mediaId;
+ },
+ onSuccess: async (mediaId) => {
+ const thumbnailUrl = objectUrlsRef.current[mediaId];
+ if (thumbnailUrl) {
+ URL.revokeObjectURL(thumbnailUrl);
+ delete objectUrlsRef.current[mediaId];
+ setThumbnailUrls({ ...objectUrlsRef.current });
+ }
+ setSessionMessage("Image restored to your timeline.");
+ await queryClient.invalidateQueries({ queryKey: VAULT_QUERY_KEY });
+ },
+ onError: (error) => {
+ if (isExpiredVaultSession(error)) {
+ clearSession("Session expired. Please unlock again.");
+ return;
+ }
+ setSessionMessage(
+ "The image could not be restored. Its encrypted copy is still safe.",
+ );
+ },
+ });
+
+ const handleLock = useCallback(() => {
+ const token = sessionToken;
+ revokeThumbnails();
+ queryClient.removeQueries({ queryKey: VAULT_QUERY_KEY });
+ vaultStore.getState().lock();
+ setSessionMessage(null);
+
+ if (token) {
+ void lockVaultSession(token).catch((error: unknown) => {
+ if (!isExpiredVaultSession(error)) {
+ setSessionMessage(
+ "Vault locked here. The server session will expire automatically.",
+ );
+ }
});
- objectUrlsRef.current = {};
- };
+ }
+ }, [queryClient, revokeThumbnails, sessionToken]);
+
+ const handleViewerError = useCallback(() => {
+ setSessionMessage(
+ "The full encrypted image could not be opened. Its preview remains available.",
+ );
}, []);
+ const handleSessionExpired = useCallback(() => {
+ clearSession("Session expired. Please unlock again.");
+ }, [clearSession]);
- if (!isUnlocked) {
+ if (!isUnlocked || !sessionToken) {
return (
@@ -149,21 +303,22 @@ export function VaultGallery() {
return (
-
-
+
+
-
- Hidden Vault
-
-
- Encrypted images unlocked for this session only.
+
+ Locked Vault
+
+
+ Originals stay encrypted at rest. This session exists in memory
+ only.
vaultStore.getState().lock()}
- className="inline-flex items-center gap-2 rounded-full border border-[var(--frost)] px-4 py-2 text-xs font-medium text-[color:var(--silver)] transition-colors hover:bg-[color:var(--frost-soft)] hover:text-[color:var(--near-white)]"
+ onClick={handleLock}
+ className="inline-flex items-center justify-center gap-2 rounded-full border border-[var(--frost)] px-4 py-2 text-xs font-medium text-[color:var(--silver)] transition-colors hover:bg-[color:var(--frost-soft)] hover:text-[color:var(--near-white)]"
>
{sessionMessage && (
-
{sessionMessage}
+
+ {sessionMessage}
+
)}
{listQuery.isLoading && (
@@ -180,68 +337,66 @@ export function VaultGallery() {
)}
- {listQuery.isError && !sessionMessage && (
+ {listQuery.isError && !isExpiredVaultSession(listQuery.error) && (
)}
- {listQuery.data && listQuery.data.length === 0 && (
-
-
-
-
- No hidden images yet
-
-
-
- )}
-
- {listQuery.data && listQuery.data.length > 0 && (
-
- {listQuery.data.map((item) => {
- const imageSrc = streamUrls[item.id];
-
- return (
-
-
- {imageSrc ? (
- // biome-ignore lint/performance/noImgElement: Vault previews use authenticated blob URLs from decrypted local streams, not public image URLs.
-
- ) : (
-
- Decrypting
-
- )}
-
-
-
- {item.filename}
-
-
- {item.created_at
- ? new Date(item.created_at).toLocaleString()
- : "Unknown date"}
-
-
- );
- })}
-
+ {listQuery.data && (
+
item.id}
+ getDate={(item) => item.created_at}
+ getWidth={(item) => item.width}
+ getHeight={(item) => item.height}
+ getThumbnailUrl={(item) => thumbnailUrls[item.id]}
+ getOriginalUrl={(item) => thumbnailUrls[item.id]}
+ getAlt={(item) => item.filename}
+ getItemTestId={(item) => `vault-item-${item.id}`}
+ getOpenTestId={(item) => `open-vault-item-${item.id}`}
+ controlsId="vault-media-timeline"
+ empty={
+
+
+
+ No locked images yet
+
+
+ Unlock the vault from Gallery to move images here.
+
+
restoreMutation.mutate(item.id)}
+ className="inline-flex items-center gap-1 rounded-full bg-black/65 px-3 py-1.5 text-xs font-medium text-white backdrop-blur transition hover:bg-black/85 disabled:cursor-wait disabled:opacity-60"
+ >
+ {restoreMutation.isPending &&
+ restoreMutation.variables === item.id ? (
+
+ )}
+ renderViewer={(props) => (
+
diff --git a/frontend/src/components/vault/VaultUnlock.tsx b/frontend/src/components/vault/VaultUnlock.tsx
index 454a35e9..22ef3129 100644
--- a/frontend/src/components/vault/VaultUnlock.tsx
+++ b/frontend/src/components/vault/VaultUnlock.tsx
@@ -2,8 +2,8 @@
import axios from "axios";
import { useState } from "react";
-import { api } from "@/lib/api";
import { vaultStore } from "@/store/vaultStore";
+import { unlockVault } from "./vault-client";
export function VaultUnlock() {
const [errorMessage, setErrorMessage] = useState
(null);
@@ -29,16 +29,18 @@ export function VaultUnlock() {
setIsSubmitting(true);
try {
- const response = await api.post<{ session_token: string }>(
- "/api/vault/unlock",
- {
- passphrase,
- },
- );
- vaultStore.getState().unlock(response.data.session_token);
+ const sessionToken = await unlockVault(passphrase);
+ vaultStore.getState().unlock(sessionToken);
} catch (error) {
if (axios.isAxiosError(error) && error.response?.status === 401) {
setErrorMessage("Incorrect vault passphrase.");
+ } else if (axios.isAxiosError(error) && error.response?.status === 400) {
+ const detail = error.response.data?.detail;
+ setErrorMessage(
+ typeof detail === "string"
+ ? detail
+ : "Use at least 8 characters for a new vault passphrase.",
+ );
} else {
setErrorMessage(
"Vault could not be unlocked right now. Please try again.",
diff --git a/frontend/src/components/vault/vault-client.ts b/frontend/src/components/vault/vault-client.ts
new file mode 100644
index 00000000..c602b4f1
--- /dev/null
+++ b/frontend/src/components/vault/vault-client.ts
@@ -0,0 +1,78 @@
+import axios from "axios";
+import { api } from "@/lib/api";
+
+export interface VaultListItem {
+ id: number;
+ filename: string;
+ content_type: string | null;
+ width: number | null;
+ height: number | null;
+ created_at: string | null;
+ hidden_at: string | null;
+}
+
+function vaultHeaders(sessionToken: string) {
+ return { Authorization: `Bearer ${sessionToken}` };
+}
+
+export async function unlockVault(passphrase: string): Promise {
+ const response = await api.post<{ session_token: string }>(
+ "/api/vault/unlock",
+ { passphrase },
+ );
+ return response.data.session_token;
+}
+
+export async function listVaultItems(
+ sessionToken: string,
+): Promise {
+ const response = await api.get("/api/vault/list", {
+ headers: vaultHeaders(sessionToken),
+ });
+ return response.data;
+}
+
+export async function lockVaultSession(sessionToken: string): Promise {
+ await api.post(
+ "/api/vault/lock",
+ {},
+ { headers: vaultHeaders(sessionToken) },
+ );
+}
+
+export async function fetchVaultThumbnail(
+ mediaId: number,
+ sessionToken: string,
+): Promise {
+ const response = await api.get(`/api/vault/thumbnail/${mediaId}`, {
+ headers: vaultHeaders(sessionToken),
+ responseType: "blob",
+ });
+ return response.data;
+}
+
+export async function fetchVaultOriginal(
+ mediaId: number,
+ sessionToken: string,
+): Promise {
+ const response = await api.get(`/api/vault/stream/${mediaId}`, {
+ headers: vaultHeaders(sessionToken),
+ responseType: "blob",
+ });
+ return response.data;
+}
+
+export async function restoreVaultItem(
+ mediaId: number,
+ sessionToken: string,
+): Promise {
+ await api.post(
+ "/api/vault/restore",
+ { media_id: mediaId },
+ { headers: vaultHeaders(sessionToken) },
+ );
+}
+
+export function isExpiredVaultSession(error: unknown): boolean {
+ return axios.isAxiosError(error) && error.response?.status === 401;
+}
diff --git a/frontend/src/lib/api.ts b/frontend/src/lib/api.ts
index b415f002..31dcc7e0 100644
--- a/frontend/src/lib/api.ts
+++ b/frontend/src/lib/api.ts
@@ -5,6 +5,7 @@ const API_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:8000";
// Create axios instance with proper configuration
export const api: AxiosInstance = axios.create({
baseURL: API_URL,
+ withCredentials: true,
headers: {
"Content-Type": "application/json",
},
@@ -210,10 +211,102 @@ export interface JobStatus {
}
export interface AppConfig {
- ml_mode: "full" | "mock";
+ ml_mode: "disabled" | "full" | "mock" | "remote";
accel_mode?: AccelMode;
}
+export interface AccountUser {
+ id: number;
+ username: string;
+ display_name: string | null;
+ role: "admin" | "member";
+}
+
+export interface AuthState {
+ mode: "local" | "shared";
+ user: AccountUser | null;
+}
+
+export interface AuthStatus {
+ mode: "local" | "shared";
+ setup_available: boolean;
+}
+
+export interface AccountSession {
+ id: number;
+ created_at: string | null;
+ expires_at: string;
+ current: boolean;
+}
+
+export const getAuthStatus = async (): Promise => {
+ const response = await api.get("/api/auth/status");
+ return response.data;
+};
+
+export const getCurrentAccount = async (): Promise => {
+ const response = await api.get("/api/auth/me");
+ return response.data;
+};
+
+export const setupAccount = async (params: {
+ username: string;
+ display_name?: string;
+ password: string;
+}): Promise<{ user: AccountUser }> => {
+ const response = await api.post<{ user: AccountUser }>(
+ "/api/auth/setup",
+ params,
+ );
+ return response.data;
+};
+
+export const loginAccount = async (params: {
+ username: string;
+ password: string;
+}): Promise<{ user: AccountUser }> => {
+ const response = await api.post<{ user: AccountUser }>(
+ "/api/auth/login",
+ params,
+ );
+ return response.data;
+};
+
+export const logoutAccount = async (): Promise => {
+ await api.post("/api/auth/logout");
+};
+
+export const updateAccountProfile = async (params: {
+ username?: string;
+ display_name?: string;
+}): Promise<{ user: AccountUser }> => {
+ const response = await api.patch<{ user: AccountUser }>(
+ "/api/auth/profile",
+ params,
+ );
+ return response.data;
+};
+
+export const changeAccountPassword = async (params: {
+ current_password: string;
+ new_password: string;
+}): Promise => {
+ await api.post("/api/auth/password", params);
+};
+
+export const getAccountSessions = async (): Promise => {
+ const response = await api.get<{ sessions: AccountSession[] }>(
+ "/api/auth/sessions",
+ );
+ return response.data.sessions;
+};
+
+export const revokeAccountSession = async (
+ sessionId: number,
+): Promise => {
+ await api.delete(`/api/auth/sessions/${sessionId}`);
+};
+
export type AccelMode = "auto" | "gpu" | "cpu";
export interface HardwareCapabilities {
@@ -245,8 +338,37 @@ export const getHardwareReport = async (): Promise => {
export interface AppSettings {
accel_mode: AccelMode;
+ ai_enabled: boolean;
+ map_enabled: boolean;
+ ml_mode: "disabled" | "full" | "mock" | "remote";
+ supported_ml_modes: string[];
+}
+
+export interface RuntimeConfig {
+ build_profile: "no-ai" | "mock" | "cpu" | "nvidia" | "development" | string;
+ supported_modes: string[];
+ configured_mode: "disabled" | "mock" | "full" | "remote";
+ configured_accel_mode: AccelMode;
+ ai_enabled: boolean;
+ map_enabled: boolean;
+ applied_mode: "disabled" | "mock" | "full" | "unavailable";
+ installed_features: string[];
+ restart_required: boolean;
+ unavailable_reason: string | null;
+ worker: {
+ health: {
+ state: "healthy" | "stale" | "unknown" | "unavailable";
+ age_seconds: number | null;
+ };
+ applied: Record | null;
+ };
}
+export const getRuntimeConfig = async (): Promise => {
+ const response = await api.get("/api/config/runtime");
+ return response.data;
+};
+
export const getSettings = async (): Promise => {
const response = await api.get("/api/settings");
return response.data;
@@ -259,6 +381,49 @@ export const updateSettings = async (
return response.data;
};
+export interface MapMarker {
+ id: number;
+ lat: number;
+ lon: number;
+ filename: string;
+ created_at: string | null;
+ thumbnail_url: string;
+ ratio: number | null;
+ liked: boolean;
+}
+
+export interface MapMarkersResponse {
+ enabled: boolean;
+ markers: MapMarker[];
+ total: number;
+}
+
+export interface MapMarkerFilters {
+ includeArchived?: boolean;
+ liked?: boolean;
+ west?: number;
+ south?: number;
+ east?: number;
+ north?: number;
+}
+
+/** Load private, account-scoped photo coordinates from the local API. */
+export const getMapMarkers = async (
+ filters: MapMarkerFilters = {},
+): Promise => {
+ const response = await api.get("/api/map/markers", {
+ params: {
+ include_archived: filters.includeArchived || undefined,
+ liked: filters.liked,
+ west: filters.west,
+ south: filters.south,
+ east: filters.east,
+ north: filters.north,
+ },
+ });
+ return response.data;
+};
+
// API Functions
export const uploadImages = async (
files: FileList | File[],
diff --git a/frontend/src/lib/media-timeline.ts b/frontend/src/lib/media-timeline.ts
new file mode 100644
index 00000000..a9869d57
--- /dev/null
+++ b/frontend/src/lib/media-timeline.ts
@@ -0,0 +1,234 @@
+/**
+ * Pure helpers for route-agnostic media timelines.
+ *
+ * The grouping and scroll-mapping behavior is adapted from the AGPL-3.0
+ * reference project's month timeline. Original copyright belongs to its
+ * authors. This file is part of Find and is distributed under AGPL-3.0.
+ * See NOTICE.
+ */
+
+import type { ScrubberLayout, ScrubberSegment } from "@/lib/timeline-scrubber";
+
+export type MediaTimelineOrder = "newest" | "oldest";
+
+export interface MediaTimelineGroup {
+ /** `YYYY-MM-01` for dated media, or `undated` when no valid date exists. */
+ timeBucket: string;
+ label: string;
+ items: T[];
+}
+
+export interface TimelineSectionMeasurement {
+ timeBucket: string;
+ /** Section top relative to the timeline root, in real rendered pixels. */
+ top: number;
+ /** Section height in real rendered pixels. */
+ height: number;
+}
+
+const MONTH_FORMATTER = new Intl.DateTimeFormat("en", {
+ month: "long",
+ timeZone: "UTC",
+ year: "numeric",
+});
+
+function validDate(value: string | null | undefined): Date | null {
+ if (!value) {
+ return null;
+ }
+
+ const date = new Date(value);
+ return Number.isNaN(date.getTime()) ? null : date;
+}
+
+export function mediaMonthBucket(
+ value: string | null | undefined,
+): string | null {
+ const date = validDate(value);
+ if (!date) {
+ return null;
+ }
+
+ const year = date.getUTCFullYear();
+ const month = String(date.getUTCMonth() + 1).padStart(2, "0");
+ return `${year}-${month}-01`;
+}
+
+export function mediaMonthLabel(timeBucket: string): string {
+ if (timeBucket === "undated") {
+ return "Undated";
+ }
+
+ const match = /^(\d{4})-(\d{2})-01$/.exec(timeBucket);
+ if (!match) {
+ return timeBucket;
+ }
+
+ const year = Number.parseInt(match[1] ?? "", 10);
+ const month = Number.parseInt(match[2] ?? "", 10);
+ if (!Number.isFinite(year) || month < 1 || month > 12) {
+ return timeBucket;
+ }
+
+ return MONTH_FORMATTER.format(new Date(Date.UTC(year, month - 1, 1)));
+}
+
+/**
+ * Group arbitrary route media by month and sort both groups and assets by date.
+ * Invalid or missing dates are retained in a final `Undated` section.
+ */
+export function groupMediaByMonth(
+ items: readonly T[],
+ getDate: (item: T) => string | null | undefined,
+ order: MediaTimelineOrder = "newest",
+): MediaTimelineGroup[] {
+ const dated = new Map>();
+ const undated: T[] = [];
+
+ for (const item of items) {
+ const value = getDate(item);
+ const date = validDate(value);
+ const timeBucket = mediaMonthBucket(value);
+ if (!date || !timeBucket) {
+ undated.push(item);
+ continue;
+ }
+
+ const group = dated.get(timeBucket) ?? [];
+ group.push({ item, timestamp: date.getTime() });
+ dated.set(timeBucket, group);
+ }
+
+ const direction = order === "newest" ? -1 : 1;
+ const groups = [...dated.entries()]
+ .sort(([left], [right]) => left.localeCompare(right) * direction)
+ .map(([timeBucket, group]) => ({
+ timeBucket,
+ label: mediaMonthLabel(timeBucket),
+ items: group
+ .sort((left, right) => (left.timestamp - right.timestamp) * direction)
+ .map(({ item }) => item),
+ }));
+
+ if (undated.length > 0) {
+ groups.push({ timeBucket: "undated", label: "Undated", items: undated });
+ }
+
+ return groups;
+}
+
+export function timelineBucketsFromGroups(
+ groups: readonly MediaTimelineGroup[],
+): Array<{ timeBucket: string; count: number }> {
+ return groups.map((group) => ({
+ timeBucket: group.timeBucket,
+ count: group.items.length,
+ }));
+}
+
+export function mediaAspectRatio(
+ width: number | null | undefined,
+ height: number | null | undefined,
+): number {
+ if (
+ typeof width !== "number" ||
+ typeof height !== "number" ||
+ !Number.isFinite(width) ||
+ !Number.isFinite(height) ||
+ width <= 0 ||
+ height <= 0
+ ) {
+ return 1;
+ }
+
+ return width / height;
+}
+
+function clamp(value: number, min: number, max: number): number {
+ return Math.min(max, Math.max(min, value));
+}
+
+function segmentForBucket(
+ layout: ScrubberLayout,
+ timeBucket: string,
+): ScrubberSegment | undefined {
+ return layout.segments.find((segment) => segment.timeBucket === timeBucket);
+}
+
+/**
+ * Translate real DOM scroll pixels into the scrubber's estimated-height space.
+ * Preserving within-section progress keeps the thumb synchronized even though
+ * justified rows make each rendered month a different height than its estimate.
+ */
+export function actualOffsetToScrubberOffset(
+ measurements: readonly TimelineSectionMeasurement[],
+ layout: ScrubberLayout,
+ actualOffset: number,
+): number {
+ if (measurements.length === 0 || layout.segments.length === 0) {
+ return 0;
+ }
+
+ const ordered = [...measurements].sort((left, right) => left.top - right.top);
+ const clampedOffset = Math.max(0, actualOffset);
+ let active = ordered[0];
+
+ for (const measurement of ordered) {
+ if (measurement.top > clampedOffset) {
+ break;
+ }
+ active = measurement;
+ }
+
+ if (!active) {
+ return 0;
+ }
+
+ const segment = segmentForBucket(layout, active.timeBucket);
+ if (!segment) {
+ return 0;
+ }
+
+ const progress =
+ active.height > 0
+ ? clamp((clampedOffset - active.top) / active.height, 0, 1)
+ : 0;
+ return segment.offsetTop + progress * segment.height;
+}
+
+/** Reverse `actualOffsetToScrubberOffset` for a scrubber-driven window jump. */
+export function scrubberOffsetToActualOffset(
+ measurements: readonly TimelineSectionMeasurement[],
+ layout: ScrubberLayout,
+ scrubberOffset: number,
+): number {
+ if (measurements.length === 0 || layout.segments.length === 0) {
+ return 0;
+ }
+
+ const clampedOffset = clamp(scrubberOffset, 0, layout.totalHeight);
+ let segment = layout.segments[0];
+ for (const candidate of layout.segments) {
+ if (candidate.offsetTop > clampedOffset) {
+ break;
+ }
+ segment = candidate;
+ }
+
+ if (!segment) {
+ return 0;
+ }
+
+ const measurement = measurements.find(
+ (candidate) => candidate.timeBucket === segment.timeBucket,
+ );
+ if (!measurement) {
+ return 0;
+ }
+
+ const progress =
+ segment.height > 0
+ ? clamp((clampedOffset - segment.offsetTop) / segment.height, 0, 1)
+ : 0;
+ return measurement.top + progress * measurement.height;
+}
diff --git a/frontend/src/lib/viewer-preload.ts b/frontend/src/lib/viewer-preload.ts
index 4fa06fd1..b2be8ed6 100644
--- a/frontend/src/lib/viewer-preload.ts
+++ b/frontend/src/lib/viewer-preload.ts
@@ -17,6 +17,8 @@ export type LoadQuality = "thumbnail" | "original";
export interface ViewerAsset {
id: number;
thumbnailUrl: string;
+ /** Context-safe accessible description for the displayed image. */
+ alt?: string;
/** Original/full-res URL; may be null until resolved. */
originalUrl?: string | null;
}
From fba69cd37dd366e05baa8e093c983bef5a123db8 Mon Sep 17 00:00:00 2001
From: Abhash Chakraborty
<80592559+Abhash-Chakraborty@users.noreply.github.com>
Date: Mon, 13 Jul 2026 02:11:00 +0530
Subject: [PATCH 03/21] build: split modular runtime artifacts
---
.dockerignore | 4 +
.env.example | 22 +++-
backend/Dockerfile | 18 ++-
compose.base.yml | 142 ++++++++++++++++++++++
compose.cpu.yml | 57 +++++++++
compose.mock.yml | 52 ++++++++
compose.no-ai.yml | 30 +++++
compose.yml | 77 ++++++++++++
docker-compose.light.yml | 149 -----------------------
docker-compose.yml | 179 ----------------------------
frontend/package.json | 3 +-
frontend/pnpm-lock.yaml | 184 +++++++++++++++++++++++++++++
frontend/src-tauri/Cargo.lock | 2 +-
frontend/src-tauri/Cargo.toml | 2 +-
frontend/src-tauri/tauri.conf.json | 2 +-
15 files changed, 575 insertions(+), 348 deletions(-)
create mode 100644 compose.base.yml
create mode 100644 compose.cpu.yml
create mode 100644 compose.mock.yml
create mode 100644 compose.no-ai.yml
create mode 100644 compose.yml
delete mode 100644 docker-compose.light.yml
delete mode 100644 docker-compose.yml
diff --git a/.dockerignore b/.dockerignore
index 4b79e62b..6510d19f 100644
--- a/.dockerignore
+++ b/.dockerignore
@@ -24,6 +24,10 @@ backend/vault_storage
**/*.sqlite3
.env
+# Read-only local comparison checkout. It must never enter a build context.
+reference-app
+@reference-app
+
# Logs and temporary files
**/*.log
**/*.tmp
diff --git a/.env.example b/.env.example
index 4137682c..43a8aa58 100644
--- a/.env.example
+++ b/.env.example
@@ -6,7 +6,7 @@
# REDIS_PASSWORD, MINIO_ROOT_USER/PASSWORD, and the matching *_URL strings).
# The API refuses to start in production while the default db/object-store
# credentials are still in place. Datastore ports are bound to 127.0.0.1 in
-# docker-compose, so the datastores are not reachable from the network.
+# Compose, so the datastores are not reachable from the network.
# ──────────────────────────────────────────────────────────────────────────
# Database
@@ -66,10 +66,19 @@ NEXT_PUBLIC_MAX_BULK_FILES=200
NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB=50
# ML Model Settings
+# Normally set by the selected compose file: no-ai | mock | cpu | nvidia.
+# It describes packages baked into the image; changing it does not install AI.
+FIND_BUILD_PROFILE=nvidia
+# disabled | mock | full | remote. The selected artifact must support the mode.
ML_MODE=full
-# Remote ML Acceleration
-# Disabled by default. Only used when ML_MODE=remote.
-# REMOTE_ML_URL must point to a self-hosted Find ML server.
+# Instance-wide AI kill switch. The dashboard persists an override in the DB,
+# and workers read it at the start of every job.
+AI_ENABLED=true
+# Opt in to retaining GPS coordinates from EXIF for the private map. Workers
+# also read this at each job boundary. False drops/clears stored coordinates.
+MAP_ENABLED=false
+# Remote ML/BYOK fields are reserved for a future self-hosted adapter. Today,
+# ML_MODE=remote is reported as unavailable and never falls back to local AI.
REMOTE_ML_URL=
REMOTE_ML_API_KEY=
REMOTE_ML_STRIP_EXIF=true
@@ -104,9 +113,10 @@ YOLO_HALF=true
# auto = use the best available accelerator, else CPU (default)
# gpu = prefer GPU; automatically fall back to CPU if unavailable
# cpu = force CPU (works on any machine)
-# See docs/guides/hardware-acceleration.md. Legacy USE_GPU=false still pins CPU
-# when ACCEL_MODE is left at auto.
+# See docs/guides/hardware-acceleration.md. A persisted dashboard value wins
+# at request/job boundaries. Legacy USE_GPU=false still pins auto mode to CPU.
ACCEL_MODE=auto
+# Used only by the default NVIDIA compose.yml profile.
BACKEND_BASE_IMAGE=nvidia/cuda:12.1.1-runtime-ubuntu22.04
BACKEND_PYTHON_VERSION=3.12
EMBEDDING_DIM=768
diff --git a/backend/Dockerfile b/backend/Dockerfile
index b1b9eaa5..14e59c3d 100644
--- a/backend/Dockerfile
+++ b/backend/Dockerfile
@@ -2,26 +2,23 @@
ARG BASE_IMAGE=python:3.12-slim
ARG PYTHON_VERSION=3.12
+ARG FIND_BUILD_PROFILE=no-ai
ARG UV_SYNC_EXTRAS=""
FROM ${BASE_IMAGE}
ARG PYTHON_VERSION=3.12
+ARG FIND_BUILD_PROFILE=no-ai
ARG UV_SYNC_EXTRAS=""
# Install system dependencies.
#
-# The set we need depends entirely on whether the ML extra is enabled:
-# * ML build (UV_SYNC_EXTRAS contains "ml") — needs a C toolchain to compile
-# hdbscan and the OpenCV/X11 runtime libs for opencv + torch vision ops, plus
-# a system python because the CUDA base image ships none.
-# * Light build (UV_SYNC_EXTRAS empty) — runs on python:3.12-slim, which already
-# has Python, and every base dependency installs from a prebuilt wheel. No
-# compiler, no OpenCV libs. Installing them anyway pulled the whole gcc-14
-# toolchain (~30 min apt) into an image that never uses it.
+# The selected build profile controls this layer. CPU and NVIDIA artifacts need
+# native build/OpenCV runtime libraries; no-AI and mock artifacts intentionally
+# stay on the minimal Python base and never install those dependencies.
#
# So we branch: full set for ML, just curl (needed to fetch uv) for light.
RUN set -eux; \
apt-get update; \
- if echo "${UV_SYNC_EXTRAS}" | grep -q "ml"; then \
+ if [ "${FIND_BUILD_PROFILE}" = "cpu" ] || [ "${FIND_BUILD_PROFILE}" = "nvidia" ]; then \
apt-get install -y --no-install-recommends \
python3 python3-dev build-essential libpq-dev \
libgl1 libglib2.0-0 libsm6 libxext6 libxrender-dev libgomp1 curl; \
@@ -45,6 +42,7 @@ ENV UV_PYTHON="${PYTHON_VERSION}"
ENV UV_LINK_MODE="copy"
ENV PATH="/opt/find/.venv/bin:/usr/local/bin:/root/.local/bin:/root/.cargo/bin:$PATH"
ENV PYTHONPATH="/app/src"
+ENV FIND_BUILD_PROFILE="${FIND_BUILD_PROFILE}"
# Set working directory
WORKDIR /app
@@ -55,7 +53,7 @@ COPY pyproject.toml uv.lock ./
# Install Python dependencies with uv. Keep uv's package cache in a BuildKit
# cache mount so it speeds rebuilds without bloating the final runtime image.
RUN --mount=type=cache,target=/root/.cache/uv \
- uv sync --no-dev --no-install-project ${UV_SYNC_EXTRAS}
+ uv sync --locked --no-dev --no-install-project ${UV_SYNC_EXTRAS}
# Copy application code
COPY . .
diff --git a/compose.base.yml b/compose.base.yml
new file mode 100644
index 00000000..136ad5ec
--- /dev/null
+++ b/compose.base.yml
@@ -0,0 +1,142 @@
+services:
+ db:
+ image: pgvector/pgvector:0.8.4-pg16-bookworm
+ environment:
+ POSTGRES_DB: find
+ POSTGRES_USER: find
+ POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+ ports:
+ - "127.0.0.1:5432:5432"
+ volumes:
+ - db_data:/var/lib/postgresql/data
+ healthcheck:
+ test: ["CMD-SHELL", "pg_isready -U find"]
+ interval: 10s
+ timeout: 5s
+ retries: 5
+
+ redis:
+ image: redis:7.4.9-alpine3.21
+ command: redis-server --loglevel warning --requirepass ${REDIS_PASSWORD}
+ hostname: redis
+ ports:
+ - "127.0.0.1:6379:6379"
+ volumes:
+ - redis_data:/data
+ healthcheck:
+ test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "ping"]
+ interval: 10s
+ timeout: 3s
+ retries: 5
+
+ minio:
+ image: minio/minio:RELEASE.2025-09-07T16-13-09Z
+ command: server /data --console-address ":9001"
+ environment:
+ MINIO_ROOT_USER: ${MINIO_ROOT_USER}
+ MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
+ ports:
+ - "127.0.0.1:${MINIO_HOST_PORT:-9200}:9000"
+ - "127.0.0.1:${MINIO_CONSOLE_HOST_PORT:-9201}:9001"
+ volumes:
+ - minio_data:/data
+ healthcheck:
+ test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
+ interval: 30s
+ timeout: 20s
+ retries: 3
+
+ api:
+ image: find-backend:no-ai
+ pull_policy: never
+ build:
+ context: ./backend
+ dockerfile: Dockerfile
+ args:
+ BASE_IMAGE: python:3.12-slim
+ PYTHON_VERSION: "3.12"
+ FIND_BUILD_PROFILE: no-ai
+ UV_SYNC_EXTRAS: ""
+ command: uvicorn find_api.main:app --host 0.0.0.0 --port 8000 --log-level warning
+ ports:
+ - "8000:8000"
+ environment: &backend-environment
+ DATABASE_URL: ${DATABASE_URL}
+ MINIO_ENDPOINT: ${MINIO_ENDPOINT:-minio:9000}
+ MINIO_PUBLIC_ENDPOINT: ${MINIO_PUBLIC_ENDPOINT:-http://localhost:9200/images}
+ MINIO_ACCESS_KEY: ${MINIO_ACCESS_KEY}
+ MINIO_SECRET_KEY: ${MINIO_SECRET_KEY}
+ MINIO_BUCKET: ${MINIO_BUCKET:-images}
+ MINIO_PUBLIC_READ: ${MINIO_PUBLIC_READ:-false}
+ MINIO_SECURE: ${MINIO_SECURE:-false}
+ REDIS_URL: ${REDIS_URL}
+ FIND_BUILD_PROFILE: no-ai
+ ML_MODE: disabled
+ AI_ENABLED: "false"
+ MAP_ENABLED: ${MAP_ENABLED:-false}
+ ACCEL_MODE: cpu
+ USE_GPU: "false"
+ API_HOST: 0.0.0.0
+ API_PORT: "8000"
+ MODEL_MANAGER_PROCESS_NAME: api
+ PYTHONUNBUFFERED: "1"
+ volumes:
+ - ./backend:/app
+ depends_on:
+ db:
+ condition: service_healthy
+ redis:
+ condition: service_healthy
+ minio:
+ condition: service_healthy
+ restart: unless-stopped
+
+ worker:
+ image: find-backend:no-ai
+ pull_policy: never
+ build:
+ context: ./backend
+ dockerfile: Dockerfile
+ args:
+ BASE_IMAGE: python:3.12-slim
+ PYTHON_VERSION: "3.12"
+ FIND_BUILD_PROFILE: no-ai
+ UV_SYNC_EXTRAS: ""
+ command: rq worker --worker-class ${RQ_WORKER_CLASS:-rq.worker.worker_classes.SimpleWorker} --url ${REDIS_URL:-redis://:find-redis-dev@redis:6379} high default low
+ environment:
+ <<: *backend-environment
+ MODEL_MANAGER_PROCESS_NAME: worker
+ volumes:
+ - ./backend:/app
+ depends_on:
+ api:
+ condition: service_started
+ redis:
+ condition: service_healthy
+ db:
+ condition: service_healthy
+ restart: unless-stopped
+
+ web:
+ build:
+ context: ./frontend
+ dockerfile: Dockerfile
+ target: production
+ ports:
+ - "3000:3000"
+ environment:
+ NEXT_PUBLIC_API_URL: http://localhost:8000
+ NEXT_PUBLIC_MINIO_BUCKET: ${NEXT_PUBLIC_MINIO_BUCKET:-images}
+ NEXT_PUBLIC_MINIO_URL: ${NEXT_PUBLIC_MINIO_URL:-http://localhost:9200}
+ NEXT_PUBLIC_MAX_BULK_FILES: ${NEXT_PUBLIC_MAX_BULK_FILES:-200}
+ NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB: ${NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB:-50}
+ NODE_ENV: production
+ depends_on:
+ api:
+ condition: service_started
+ restart: unless-stopped
+
+volumes:
+ db_data:
+ redis_data:
+ minio_data:
diff --git a/compose.cpu.yml b/compose.cpu.yml
new file mode 100644
index 00000000..1c8ba1d9
--- /dev/null
+++ b/compose.cpu.yml
@@ -0,0 +1,57 @@
+services:
+ db:
+ extends:
+ file: compose.base.yml
+ service: db
+ redis:
+ extends:
+ file: compose.base.yml
+ service: redis
+ minio:
+ extends:
+ file: compose.base.yml
+ service: minio
+ api:
+ extends:
+ file: compose.base.yml
+ service: api
+ image: find-backend:cpu
+ build:
+ args:
+ FIND_BUILD_PROFILE: cpu
+ UV_SYNC_EXTRAS: "--extra cpu"
+ environment:
+ FIND_BUILD_PROFILE: cpu
+ ML_MODE: full
+ AI_ENABLED: "${AI_ENABLED:-true}"
+ ACCEL_MODE: "${ACCEL_MODE:-cpu}"
+ USE_GPU: "false"
+ volumes:
+ - model_cache:/root/.cache
+ worker:
+ extends:
+ file: compose.base.yml
+ service: worker
+ image: find-backend:cpu
+ build:
+ args:
+ FIND_BUILD_PROFILE: cpu
+ UV_SYNC_EXTRAS: "--extra cpu"
+ environment:
+ FIND_BUILD_PROFILE: cpu
+ ML_MODE: full
+ AI_ENABLED: "${AI_ENABLED:-true}"
+ ACCEL_MODE: "${ACCEL_MODE:-cpu}"
+ USE_GPU: "false"
+ volumes:
+ - model_cache:/root/.cache
+ web:
+ extends:
+ file: compose.base.yml
+ service: web
+
+volumes:
+ db_data:
+ redis_data:
+ minio_data:
+ model_cache:
diff --git a/compose.mock.yml b/compose.mock.yml
new file mode 100644
index 00000000..bd1c0a7c
--- /dev/null
+++ b/compose.mock.yml
@@ -0,0 +1,52 @@
+services:
+ db:
+ extends:
+ file: compose.base.yml
+ service: db
+ redis:
+ extends:
+ file: compose.base.yml
+ service: redis
+ minio:
+ extends:
+ file: compose.base.yml
+ service: minio
+ api:
+ extends:
+ file: compose.base.yml
+ service: api
+ image: find-backend:mock
+ build:
+ args:
+ FIND_BUILD_PROFILE: mock
+ UV_SYNC_EXTRAS: "--extra mock"
+ environment:
+ FIND_BUILD_PROFILE: mock
+ ML_MODE: mock
+ AI_ENABLED: "${AI_ENABLED:-true}"
+ ACCEL_MODE: cpu
+ USE_GPU: "false"
+ worker:
+ extends:
+ file: compose.base.yml
+ service: worker
+ image: find-backend:mock
+ build:
+ args:
+ FIND_BUILD_PROFILE: mock
+ UV_SYNC_EXTRAS: "--extra mock"
+ environment:
+ FIND_BUILD_PROFILE: mock
+ ML_MODE: mock
+ AI_ENABLED: "${AI_ENABLED:-true}"
+ ACCEL_MODE: cpu
+ USE_GPU: "false"
+ web:
+ extends:
+ file: compose.base.yml
+ service: web
+
+volumes:
+ db_data:
+ redis_data:
+ minio_data:
diff --git a/compose.no-ai.yml b/compose.no-ai.yml
new file mode 100644
index 00000000..dd80faee
--- /dev/null
+++ b/compose.no-ai.yml
@@ -0,0 +1,30 @@
+services:
+ db:
+ extends:
+ file: compose.base.yml
+ service: db
+ redis:
+ extends:
+ file: compose.base.yml
+ service: redis
+ minio:
+ extends:
+ file: compose.base.yml
+ service: minio
+ api:
+ extends:
+ file: compose.base.yml
+ service: api
+ worker:
+ extends:
+ file: compose.base.yml
+ service: worker
+ web:
+ extends:
+ file: compose.base.yml
+ service: web
+
+volumes:
+ db_data:
+ redis_data:
+ minio_data:
diff --git a/compose.yml b/compose.yml
new file mode 100644
index 00000000..b2c97bbf
--- /dev/null
+++ b/compose.yml
@@ -0,0 +1,77 @@
+services:
+ db:
+ extends:
+ file: compose.base.yml
+ service: db
+ redis:
+ extends:
+ file: compose.base.yml
+ service: redis
+ minio:
+ extends:
+ file: compose.base.yml
+ service: minio
+ api:
+ extends:
+ file: compose.base.yml
+ service: api
+ image: find-backend:nvidia
+ build:
+ args:
+ BASE_IMAGE: "${BACKEND_BASE_IMAGE:-nvidia/cuda:12.1.1-runtime-ubuntu22.04}"
+ FIND_BUILD_PROFILE: nvidia
+ UV_SYNC_EXTRAS: "--extra nvidia"
+ environment:
+ FIND_BUILD_PROFILE: nvidia
+ ML_MODE: full
+ AI_ENABLED: "${AI_ENABLED:-true}"
+ ACCEL_MODE: "${ACCEL_MODE:-auto}"
+ USE_GPU: "true"
+ volumes:
+ - model_cache:/root/.cache
+ gpus: all
+ deploy:
+ resources:
+ reservations:
+ devices:
+ - driver: nvidia
+ count: 1
+ capabilities: [gpu]
+ worker:
+ extends:
+ file: compose.base.yml
+ service: worker
+ image: find-backend:nvidia
+ build:
+ args:
+ BASE_IMAGE: "${BACKEND_BASE_IMAGE:-nvidia/cuda:12.1.1-runtime-ubuntu22.04}"
+ FIND_BUILD_PROFILE: nvidia
+ UV_SYNC_EXTRAS: "--extra nvidia"
+ environment:
+ FIND_BUILD_PROFILE: nvidia
+ ML_MODE: full
+ AI_ENABLED: "${AI_ENABLED:-true}"
+ ACCEL_MODE: "${ACCEL_MODE:-auto}"
+ USE_GPU: "true"
+ volumes:
+ - model_cache:/root/.cache
+ gpus: all
+ deploy:
+ resources:
+ limits:
+ memory: ${WORKER_MEMORY_LIMIT:-8G}
+ reservations:
+ devices:
+ - driver: nvidia
+ count: 1
+ capabilities: [gpu]
+ web:
+ extends:
+ file: compose.base.yml
+ service: web
+
+volumes:
+ db_data:
+ redis_data:
+ minio_data:
+ model_cache:
diff --git a/docker-compose.light.yml b/docker-compose.light.yml
deleted file mode 100644
index 84cb11a5..00000000
--- a/docker-compose.light.yml
+++ /dev/null
@@ -1,149 +0,0 @@
-x-light-backend: &light-backend
- image: find-light-backend
- pull_policy: never
- build:
- context: ./backend
- dockerfile: Dockerfile
- args:
- BASE_IMAGE: python:3.12-slim
- PYTHON_VERSION: "3.12"
- UV_SYNC_EXTRAS: ""
-
-services:
- db:
- image: pgvector/pgvector:0.8.4-pg16-bookworm
- container_name: find-light-db
- # Local-only defaults for contributor setup. Override via .env for anything else.
- environment:
- POSTGRES_DB: find
- POSTGRES_USER: find
- POSTGRES_PASSWORD: find123
- ports:
- # Loopback only — contributor setup is single-machine.
- - "127.0.0.1:5432:5432"
- volumes:
- - light_db_data:/var/lib/postgresql/data
- healthcheck:
- test: ["CMD-SHELL", "pg_isready -U find"]
- interval: 10s
- timeout: 5s
- retries: 5
-
- redis:
- image: redis:7.4.9-alpine3.21
- command: redis-server --loglevel warning
- container_name: find-light-redis
- ports:
- - "127.0.0.1:6379:6379"
- volumes:
- - light_redis_data:/data
- healthcheck:
- test: ["CMD", "redis-cli", "ping"]
- interval: 10s
- timeout: 3s
- retries: 5
-
- minio:
- image: minio/minio:RELEASE.2025-09-07T16-13-09Z
- container_name: find-light-minio
- command: server /data --console-address ":9001"
- # Local-only defaults for contributor setup. Never reuse these credentials in production.
- environment:
- MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin}
- MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:-minioadmin}
- ports:
- - "127.0.0.1:${MINIO_HOST_PORT:-9200}:9000"
- - "127.0.0.1:${MINIO_CONSOLE_HOST_PORT:-9201}:9001"
- volumes:
- - light_minio_data:/data
- healthcheck:
- test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
- interval: 30s
- timeout: 20s
- retries: 3
-
- api:
- <<: *light-backend
- container_name: find-light-api
- command: uvicorn find_api.main:app --host 0.0.0.0 --port 8000 --log-level warning
- ports:
- - "8000:8000"
- environment:
- - DATABASE_URL=postgresql://find:find123@db:5432/find
- - MINIO_ENDPOINT=minio:9000
- - MINIO_PUBLIC_ENDPOINT=${MINIO_PUBLIC_ENDPOINT:-http://localhost:9200/images}
- - MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY:-minioadmin}
- - MINIO_SECRET_KEY=${MINIO_SECRET_KEY:-minioadmin}
- - MINIO_BUCKET=${MINIO_BUCKET:-images}
- - MINIO_PUBLIC_READ=false
- - MINIO_SECURE=false
- - REDIS_URL=redis://redis:6379
- - ML_MODE=mock
- - USE_GPU=false
- - API_HOST=0.0.0.0
- - API_PORT=8000
- - MODEL_MANAGER_PROCESS_NAME=api
- - PYTHONUNBUFFERED=1
- volumes:
- - ./backend:/app
- depends_on:
- db:
- condition: service_healthy
- redis:
- condition: service_healthy
- minio:
- condition: service_healthy
- restart: unless-stopped
-
- worker:
- <<: *light-backend
- container_name: find-light-worker
- command: rq worker --worker-class ${RQ_WORKER_CLASS:-rq.worker.worker_classes.SimpleWorker} --url redis://redis:6379 high default low
- environment:
- - DATABASE_URL=postgresql://find:find123@db:5432/find
- - MINIO_ENDPOINT=minio:9000
- - MINIO_PUBLIC_ENDPOINT=${MINIO_PUBLIC_ENDPOINT:-http://localhost:9200/images}
- - MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY:-minioadmin}
- - MINIO_SECRET_KEY=${MINIO_SECRET_KEY:-minioadmin}
- - MINIO_BUCKET=${MINIO_BUCKET:-images}
- - MINIO_PUBLIC_READ=false
- - MINIO_SECURE=false
- - REDIS_URL=redis://redis:6379
- - ML_MODE=mock
- - USE_GPU=false
- - MODEL_MANAGER_PROCESS_NAME=worker
- - PYTHONUNBUFFERED=1
- volumes:
- - ./backend:/app
- depends_on:
- - api
- - redis
- - db
- restart: unless-stopped
-
- web:
- build:
- context: ./frontend
- dockerfile: Dockerfile
- target: production
- container_name: find-light-web
- ports:
- - "3000:3000"
- environment:
- - NEXT_PUBLIC_API_URL=http://localhost:8000
- - NEXT_PUBLIC_MINIO_BUCKET=${NEXT_PUBLIC_MINIO_BUCKET:-images}
- - NEXT_PUBLIC_MINIO_URL=${NEXT_PUBLIC_MINIO_URL:-http://localhost:9200}
- - NEXT_PUBLIC_MAX_BULK_FILES=${NEXT_PUBLIC_MAX_BULK_FILES:-200}
- - NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB=${NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB:-50}
- - NODE_ENV=production
- depends_on:
- - api
- restart: unless-stopped
-
-volumes:
- light_db_data:
- driver: local
- light_redis_data:
- driver: local
- light_minio_data:
- driver: local
diff --git a/docker-compose.yml b/docker-compose.yml
deleted file mode 100644
index 0f4a70f5..00000000
--- a/docker-compose.yml
+++ /dev/null
@@ -1,179 +0,0 @@
-x-full-backend: &full-backend
- image: find-backend
- pull_policy: never
- build:
- context: ./backend
- dockerfile: Dockerfile
- args:
- BASE_IMAGE: ${BACKEND_BASE_IMAGE:-nvidia/cuda:12.1.1-runtime-ubuntu22.04}
- PYTHON_VERSION: ${BACKEND_PYTHON_VERSION:-3.12}
- UV_SYNC_EXTRAS: "--extra ml"
-
-services:
- # PostgreSQL Database with pgvector
- db:
- image: pgvector/pgvector:0.8.4-pg16-bookworm
- container_name: find-db
- environment:
- POSTGRES_DB: find
- POSTGRES_USER: find
- POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-find123}
- ports:
- # Bound to loopback only: other services reach the db over the compose
- # network. Not network-exposed, so the default password is not remotely
- # reachable. Override the bind address for remote admin access.
- - "127.0.0.1:5432:5432"
- volumes:
- - db_data:/var/lib/postgresql/data
- healthcheck:
- test: ["CMD-SHELL", "pg_isready -U find"]
- interval: 10s
- timeout: 5s
- retries: 5
-
- # Redis for job queue
- redis:
- image: redis:7.4.9-alpine3.21
- command: redis-server --loglevel warning --requirepass ${REDIS_PASSWORD:-find-redis-dev}
- container_name: find-redis
- hostname: redis
- ports:
- # Loopback only — the queue is internal to the compose network.
- - "127.0.0.1:6379:6379"
- volumes:
- - redis_data:/data
- healthcheck:
- test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD:-find-redis-dev}", "ping"]
- interval: 10s
- timeout: 3s
- retries: 5
-
- # MinIO for object storage
- minio:
- image: minio/minio:RELEASE.2025-09-07T16-13-09Z
- container_name: find-minio
- command: server /data --console-address ":9001"
- environment:
- MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin}
- MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:-minioadmin}
- ports:
- # Loopback only by default. Browser access to images goes through the
- # API/next image proxy, not directly to MinIO.
- - "127.0.0.1:${MINIO_HOST_PORT:-9200}:9000"
- - "127.0.0.1:${MINIO_CONSOLE_HOST_PORT:-9201}:9001"
- volumes:
- - minio_data:/data
- healthcheck:
- test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
- interval: 30s
- timeout: 20s
- retries: 3
-
- # FastAPI Backend
- api:
- <<: *full-backend
- container_name: find-api
- command: uvicorn find_api.main:app --host 0.0.0.0 --port 8000 --log-level warning
- ports:
- - "8000:8000"
- environment:
- - DATABASE_URL=${DATABASE_URL:-postgresql://find:find123@db:5432/find}
- - MINIO_ENDPOINT=${MINIO_ENDPOINT:-minio:9000}
- - MINIO_PUBLIC_ENDPOINT=${MINIO_PUBLIC_ENDPOINT:-http://localhost:9200/images}
- - MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY:-minioadmin}
- - MINIO_SECRET_KEY=${MINIO_SECRET_KEY:-minioadmin}
- - MINIO_BUCKET=${MINIO_BUCKET:-images}
- - MINIO_PUBLIC_READ=${MINIO_PUBLIC_READ:-false}
- - MINIO_SECURE=${MINIO_SECURE:-false}
- - REDIS_URL=${REDIS_URL:-redis://:find-redis-dev@redis:6379}
- - USE_GPU=${USE_GPU:-true}
- - API_HOST=0.0.0.0
- - API_PORT=8000
- - MODEL_MANAGER_PROCESS_NAME=api
- - PYTHONUNBUFFERED=1
- volumes:
- - ./backend:/app
- - model_cache:/root/.cache
- gpus: all
- deploy:
- resources:
- reservations:
- devices:
- - driver: nvidia
- count: 1
- capabilities: [gpu]
- depends_on:
- db:
- condition: service_healthy
- redis:
- condition: service_healthy
- minio:
- condition: service_healthy
- restart: unless-stopped
-
- # RQ Worker for background ML processing
- worker:
- <<: *full-backend
- container_name: find-worker
- command: rq worker --worker-class ${RQ_WORKER_CLASS:-rq.worker.worker_classes.SimpleWorker} --url ${REDIS_URL:-redis://:find-redis-dev@redis:6379} high default low
- environment:
- - DATABASE_URL=${DATABASE_URL:-postgresql://find:find123@db:5432/find}
- - MINIO_ENDPOINT=${MINIO_ENDPOINT:-minio:9000}
- - MINIO_PUBLIC_ENDPOINT=${MINIO_PUBLIC_ENDPOINT:-http://localhost:9200/images}
- - MINIO_ACCESS_KEY=${MINIO_ACCESS_KEY:-minioadmin}
- - MINIO_SECRET_KEY=${MINIO_SECRET_KEY:-minioadmin}
- - MINIO_BUCKET=${MINIO_BUCKET:-images}
- - MINIO_PUBLIC_READ=${MINIO_PUBLIC_READ:-false}
- - MINIO_SECURE=${MINIO_SECURE:-false}
- - REDIS_URL=${REDIS_URL:-redis://:find-redis-dev@redis:6379}
- - USE_GPU=${USE_GPU:-true}
- - MODEL_MANAGER_PROCESS_NAME=worker
- - PYTHONUNBUFFERED=1
- volumes:
- - ./backend:/app
- - model_cache:/root/.cache
- depends_on:
- - api
- - redis
- - db
- restart: unless-stopped
- gpus: all
- deploy:
- resources:
- limits:
- memory: 8G
- reservations:
- devices:
- - driver: nvidia
- count: 1
- capabilities: [gpu]
-
- # Next.js Frontend
- web:
- build:
- context: ./frontend
- dockerfile: Dockerfile
- target: production
- container_name: find-web
- ports:
- - "3000:3000"
- environment:
- - NEXT_PUBLIC_API_URL=http://localhost:8000
- - NEXT_PUBLIC_MINIO_BUCKET=${NEXT_PUBLIC_MINIO_BUCKET:-images}
- - NEXT_PUBLIC_MINIO_URL=${NEXT_PUBLIC_MINIO_URL:-http://localhost:9200}
- - NEXT_PUBLIC_MAX_BULK_FILES=${NEXT_PUBLIC_MAX_BULK_FILES:-200}
- - NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB=${NEXT_PUBLIC_MAX_UPLOAD_SIZE_MB:-50}
- - NODE_ENV=production
- depends_on:
- - api
- restart: unless-stopped
-
-volumes:
- db_data:
- driver: local
- redis_data:
- driver: local
- minio_data:
- driver: local
- model_cache:
- driver: local
diff --git a/frontend/package.json b/frontend/package.json
index 569cec30..9555b7d5 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,6 +1,6 @@
{
"name": "find-frontend",
- "version": "1.0.0",
+ "version": "1.1.0",
"packageManager": "pnpm@11.3.0",
"private": true,
"license": "AGPL-3.0-only",
@@ -25,6 +25,7 @@
"clsx": "^2.1.1",
"date-fns": "^4.1.0",
"lucide-react": "^1.14.0",
+ "maplibre-gl": "^5.24.0",
"next": "^16.2.6",
"react": "^19.2.5",
"react-dom": "^19.2.5",
diff --git a/frontend/pnpm-lock.yaml b/frontend/pnpm-lock.yaml
index c466e4b4..4e2f4766 100644
--- a/frontend/pnpm-lock.yaml
+++ b/frontend/pnpm-lock.yaml
@@ -32,6 +32,9 @@ importers:
lucide-react:
specifier: ^1.14.0
version: 1.14.0(react@19.2.5)
+ maplibre-gl:
+ specifier: ^5.24.0
+ version: 5.24.0
next:
specifier: ^16.2.6
version: 16.2.6(@playwright/test@1.61.0)(react-dom@19.2.5(react@19.2.5))(react@19.2.5)
@@ -430,6 +433,42 @@ packages:
'@jridgewell/trace-mapping@0.3.31':
resolution: {integrity: sha512-zzNR+SdQSDJzc8joaeP8QQoCQr8NuYx2dIIytl1QeBEZHJ9uW6hebsrYgbz8hJwUQao3TWCMtmfV8Nu1twOLAw==}
+ '@mapbox/jsonlint-lines-primitives@2.0.3':
+ resolution: {integrity: sha512-0SElaV0uMxEnxzBhhX9WTuPyUeMsAN/SS0i16tjuba4/mio63MG9khjC1a0JAiPGXAwvwm4UfHJURCN7nyudQg==}
+ engines: {node: '>= 22'}
+
+ '@mapbox/point-geometry@1.1.0':
+ resolution: {integrity: sha512-YGcBz1cg4ATXDCM/71L9xveh4dynfGmcLDqufR+nQQy3fKwsAZsWd/x4621/6uJaeB9mwOHE6hPeDgXz9uViUQ==}
+
+ '@mapbox/tiny-sdf@2.2.0':
+ resolution: {integrity: sha512-LVL4wgI9YAum5V+LNVQO6QgFBPw7/MIIY4XJPNsPDMrjEwcE+JfKk1LuIl8GnF197ejVdC9QdPaxrx5gfgdGXg==}
+
+ '@mapbox/unitbezier@0.0.1':
+ resolution: {integrity: sha512-nMkuDXFv60aBr9soUG5q+GvZYL+2KZHVvsqFCzqnkGEf46U2fvmytHaEVc1/YZbiLn8X+eR3QzX1+dwDO1lxlw==}
+
+ '@mapbox/unitbezier@1.0.0':
+ resolution: {integrity: sha512-fqd515fjBmANKGGsQ286E2Wvj/XvDFpGzwJxq4CI6jMQue6Oy04uCKp+JWKF00xRTmk6cEu1jPJ9p3xqH8YWqQ==}
+
+ '@mapbox/vector-tile@2.0.5':
+ resolution: {integrity: sha512-pXj8m7KTsqZt+1jsE0xIpGvqTSbblfkuEJL/NJmNePMtEwxO8V3XMDo9WMSfDeqHvCtBI9Lmt4mGcGR10zecmw==}
+
+ '@mapbox/whoots-js@3.1.0':
+ resolution: {integrity: sha512-Es6WcD0nO5l+2BOQS4uLfNPYQaNDfbot3X1XUoloz+x0mPDS3eeORZJl06HXjwBG1fOGwCRnzK88LMdxKRrd6Q==}
+ engines: {node: '>=6.0.0'}
+
+ '@maplibre/geojson-vt@6.1.1':
+ resolution: {integrity: sha512-FVMOcmSP/yqol45t7StApEyTL5/vmqBCuFhH9n+fFuINenhaX+YgHHIt1yJ86S8kln3uJLcMvmEU2cfn6E2eCQ==}
+
+ '@maplibre/maplibre-gl-style-spec@24.10.0':
+ resolution: {integrity: sha512-lichxSiagMEBBrqHF0trtMQH9RKh+9jUlIJl0qW0QHvt2H/tbvUWdE+ZzI2Jd0/pT7j/iavLonlPu7EQ/ixTOw==}
+ hasBin: true
+
+ '@maplibre/mlt@1.1.12':
+ resolution: {integrity: sha512-ZeK5w2TTeHOajcLaEQs1KZXw2V9wIKo1PmThlxlsHoXsQsYlBqLJzPOd6tJHRtGTChUY3DPPmjXRArYVvAbmZw==}
+
+ '@maplibre/vt-pbf@4.3.2':
+ resolution: {integrity: sha512-j6p0AdjvAR19Z3XaCysle7A4ZSo08tYOzxD0Y9NQylwPAkwJJeYub5b2eVucdeDh7erhv69DahoLOevDRERRUw==}
+
'@napi-rs/wasm-runtime@1.1.4':
resolution: {integrity: sha512-3NQNNgA1YSlJb/kMH1ildASP9HW7/7kYnRI2szWJaofaS1hWmbGI4H+d3+22aGzXXN9IJ+n+GiFVcGipJP18ow==}
peerDependencies:
@@ -737,6 +776,9 @@ packages:
'@types/estree@1.0.9':
resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==}
+ '@types/geojson@7946.0.16':
+ resolution: {integrity: sha512-6C8nqWur3j98U6+lXDfTUWIfgvZU+EumvpHKcYjujKH7woYyLj2sUmff0tRhrqM7BohUw7Pz3ZB1jj2gW9Fvmg==}
+
'@types/node@22.19.1':
resolution: {integrity: sha512-LCCV0HdSZZZb34qifBsyWlUmok6W7ouER+oQIGBScS8EsZsQbrtFTUrDX4hOl+CS6p7cnNC4td+qrSVGSCTUfQ==}
@@ -962,6 +1004,9 @@ packages:
resolution: {integrity: sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==}
engines: {node: '>= 0.4'}
+ earcut@3.2.3:
+ resolution: {integrity: sha512-vnS4AVwp1KHAF13i1vp1/2D5evWy3k5u/iW/B81QVsUZtV8cv2tU0b2VNFlqvh4kYwrFMDdjPCfAmfyJW9y14Q==}
+
electron-to-chromium@1.5.348:
resolution: {integrity: sha512-QC2X59nRlycQQMc4ZXjSVBX+tSgJfgRtcrYHbIZLgOV2dCvefoQGegLR7lLXKgpPpSuVmJU19LMzGrSa2C7k3Q==}
@@ -1060,6 +1105,9 @@ packages:
resolution: {integrity: sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==}
engines: {node: '>= 0.4'}
+ gl-matrix@3.4.4:
+ resolution: {integrity: sha512-latSnyDNt/8zYUB6VIJ6PCh2jBjJX6gnDsoCZ7LyW7GkqrD51EWwa9qCoGixj8YqBtETQK/xY7OmpTF8xz1DdQ==}
+
glob-parent@5.1.2:
resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
engines: {node: '>= 6'}
@@ -1134,6 +1182,12 @@ packages:
canvas:
optional: true
+ json-stringify-pretty-compact@4.0.0:
+ resolution: {integrity: sha512-3CNZ2DnrpByG9Nqj6Xo8vqbjT4F6N+tb4Gb28ESAZjYZ5yqvmc56J+/kuIwkaAMOyblTQhUW7PxMkUb8Q36N3Q==}
+
+ kdbush@4.1.0:
+ resolution: {integrity: sha512-e9vurzrXJQrFX6ckpHP3bvj5l+9CnYzkxDNnNQ1h2QTqdWsUAJgXiKdGNcOa1EY85dU8KbQ+z/FdQdB7P+9yfQ==}
+
lightningcss-android-arm64@1.32.0:
resolution: {integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==}
engines: {node: '>= 12.0.0'}
@@ -1235,6 +1289,10 @@ packages:
magic-string@0.30.21:
resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}
+ maplibre-gl@5.24.0:
+ resolution: {integrity: sha512-ALyFxgtd5R+65UqZ/++lOqwWcC0SNho9c27fYSyLmG7AfnAul2o46F05aDJGPbFU57wos9dgcIySHs0Xe6ia3A==}
+ engines: {node: '>=16.14.0', npm: '>=8.1.0'}
+
math-intrinsics@1.1.0:
resolution: {integrity: sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==}
engines: {node: '>= 0.4'}
@@ -1262,6 +1320,12 @@ packages:
resolution: {integrity: sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==}
engines: {node: '>=4'}
+ minimist@1.2.8:
+ resolution: {integrity: sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==}
+
+ murmurhash-js@1.0.0:
+ resolution: {integrity: sha512-TvmkNhkv8yct0SVBSy+o8wYzXjE4Zz3PCesbfs8HiCXXdcTuocApFv11UWlNFWKYsP2okqrhb7JNlSm9InBhIw==}
+
mz@2.7.0:
resolution: {integrity: sha512-z81GNO7nnYMEhrGh9LeymoE4+Yr0Wn5McHIZMK5cfQCl+NDX08sCZgUc9/6MHni9IWuFLm1Z3HTCXu2z9fN62Q==}
@@ -1322,6 +1386,14 @@ packages:
pathe@2.0.3:
resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==}
+ pbf@4.0.2:
+ resolution: {integrity: sha512-J0ajxARhZfpUEebxYs1vhMGMuLSXtBe1e+fFPDrf2uA2hgo+UshKfNUWOz92HJNz6/NFEXseQPddnHkTreWRqg==}
+ hasBin: true
+
+ pbf@5.1.0:
+ resolution: {integrity: sha512-Wv0yo0+uZepnoNEKsquhar1F18LogB8oeEikIhUXG16udbiXG7JecHGySwoo6kuMgjmbQYzdrTZlO+/K9t8eZg==}
+ hasBin: true
+
picocolors@1.1.1:
resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
@@ -1402,6 +1474,9 @@ packages:
resolution: {integrity: sha512-FfR8sjd4em2T6fb3I2MwAJU7HWVMr9zba+enmQeeWFfCbm+UOC/0X4DS8XtpUTMwWMGbjKYP7xjfNekzyGmB3A==}
engines: {node: ^10 || ^12 || >=14}
+ potpack@2.1.0:
+ resolution: {integrity: sha512-pcaShQc1Shq0y+E7GqJqvZj8DTthWV1KeHGdi0Z6IAin2Oi3JnLCOfwnCo84qc+HAp52wT9nK9H7FAJp5a44GQ==}
+
pretty-format@27.5.1:
resolution: {integrity: sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==}
engines: {node: ^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0}
@@ -1409,6 +1484,9 @@ packages:
prop-types@15.8.1:
resolution: {integrity: sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==}
+ protocol-buffers-schema@3.6.1:
+ resolution: {integrity: sha512-VG2K63Igkiv9p76tk1lilczEK1cT+kCjKtkdhw1dQZV3k3IXJbd3o6Ho8b9zJZaHSnT2hKe4I+ObmX9w6m5SmQ==}
+
proxy-from-env@2.1.0:
resolution: {integrity: sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA==}
engines: {node: '>=10'}
@@ -1420,6 +1498,9 @@ packages:
queue-microtask@1.2.3:
resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
+ quickselect@3.0.0:
+ resolution: {integrity: sha512-XdjUArbK4Bm5fLLvlm5KpTFOiOThgfWWI4axAZDWg4E/0mKdZyI9tNEfds27qCi1ze/vwTR16kvmmGhRra3c2g==}
+
react-dom@19.2.5:
resolution: {integrity: sha512-J5bAZz+DXMMwW/wV3xzKke59Af6CHY7G4uYLN1OvBcKEsWOs4pQExj86BBKamxl/Ik5bx9whOrvBlSDfWzgSag==}
peerDependencies:
@@ -1456,6 +1537,9 @@ packages:
resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
engines: {node: '>=0.10.0'}
+ resolve-protobuf-schema@2.1.0:
+ resolution: {integrity: sha512-kI5ffTiZWmJaS/huM8wZfEMer1eRd7oJQhDuxeCLe3t7N7mX3z94CN0xPxBQxFYQTSNz9T0i+v6inKqSdK8xrQ==}
+
resolve@1.22.11:
resolution: {integrity: sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==}
engines: {node: '>= 0.4'}
@@ -1580,6 +1664,9 @@ packages:
resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==}
engines: {node: '>=12.0.0'}
+ tinyqueue@3.0.0:
+ resolution: {integrity: sha512-gRa9gwYU3ECmQYv3lslts5hxuIa90veaEcxDYuu3QGOIAEM2mOZkVHp48ANJuu1CURtRdHKUBY5Lm1tHV+sD4g==}
+
tinyrainbow@3.1.0:
resolution: {integrity: sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==}
engines: {node: '>=14.0.0'}
@@ -1997,6 +2084,47 @@ snapshots:
'@jridgewell/resolve-uri': 3.1.2
'@jridgewell/sourcemap-codec': 1.5.5
+ '@mapbox/jsonlint-lines-primitives@2.0.3': {}
+
+ '@mapbox/point-geometry@1.1.0': {}
+
+ '@mapbox/tiny-sdf@2.2.0': {}
+
+ '@mapbox/unitbezier@0.0.1': {}
+
+ '@mapbox/unitbezier@1.0.0': {}
+
+ '@mapbox/vector-tile@2.0.5':
+ dependencies:
+ '@mapbox/point-geometry': 1.1.0
+ '@types/geojson': 7946.0.16
+ pbf: 4.0.2
+
+ '@mapbox/whoots-js@3.1.0': {}
+
+ '@maplibre/geojson-vt@6.1.1':
+ dependencies:
+ kdbush: 4.1.0
+
+ '@maplibre/maplibre-gl-style-spec@24.10.0':
+ dependencies:
+ '@mapbox/jsonlint-lines-primitives': 2.0.3
+ '@mapbox/unitbezier': 1.0.0
+ json-stringify-pretty-compact: 4.0.0
+ minimist: 1.2.8
+ quickselect: 3.0.0
+ tinyqueue: 3.0.0
+
+ '@maplibre/mlt@1.1.12':
+ dependencies:
+ '@mapbox/point-geometry': 1.1.0
+
+ '@maplibre/vt-pbf@4.3.2':
+ dependencies:
+ '@mapbox/point-geometry': 1.1.0
+ '@types/geojson': 7946.0.16
+ pbf: 5.1.0
+
'@napi-rs/wasm-runtime@1.1.4(@emnapi/core@1.10.0)(@emnapi/runtime@1.10.0)':
dependencies:
'@emnapi/core': 1.10.0
@@ -2205,6 +2333,8 @@ snapshots:
'@types/estree@1.0.9': {}
+ '@types/geojson@7946.0.16': {}
+
'@types/node@22.19.1':
dependencies:
undici-types: 6.21.0
@@ -2419,6 +2549,8 @@ snapshots:
es-errors: 1.3.0
gopd: 1.2.0
+ earcut@3.2.3: {}
+
electron-to-chromium@1.5.348: {}
entities@8.0.0: {}
@@ -2510,6 +2642,8 @@ snapshots:
dunder-proto: 1.0.1
es-object-atoms: 1.1.2
+ gl-matrix@3.4.4: {}
+
glob-parent@5.1.2:
dependencies:
is-glob: 4.0.3
@@ -2588,6 +2722,10 @@ snapshots:
transitivePeerDependencies:
- '@noble/hashes'
+ json-stringify-pretty-compact@4.0.0: {}
+
+ kdbush@4.1.0: {}
+
lightningcss-android-arm64@1.32.0:
optional: true
@@ -2657,6 +2795,28 @@ snapshots:
dependencies:
'@jridgewell/sourcemap-codec': 1.5.5
+ maplibre-gl@5.24.0:
+ dependencies:
+ '@mapbox/jsonlint-lines-primitives': 2.0.3
+ '@mapbox/point-geometry': 1.1.0
+ '@mapbox/tiny-sdf': 2.2.0
+ '@mapbox/unitbezier': 0.0.1
+ '@mapbox/vector-tile': 2.0.5
+ '@mapbox/whoots-js': 3.1.0
+ '@maplibre/geojson-vt': 6.1.1
+ '@maplibre/maplibre-gl-style-spec': 24.10.0
+ '@maplibre/mlt': 1.1.12
+ '@maplibre/vt-pbf': 4.3.2
+ '@types/geojson': 7946.0.16
+ earcut: 3.2.3
+ gl-matrix: 3.4.4
+ kdbush: 4.1.0
+ murmurhash-js: 1.0.0
+ pbf: 4.0.2
+ potpack: 2.1.0
+ quickselect: 3.0.0
+ tinyqueue: 3.0.0
+
math-intrinsics@1.1.0: {}
mdn-data@2.27.1: {}
@@ -2676,6 +2836,10 @@ snapshots:
min-indent@1.0.1: {}
+ minimist@1.2.8: {}
+
+ murmurhash-js@1.0.0: {}
+
mz@2.7.0:
dependencies:
any-promise: 1.3.0
@@ -2729,6 +2893,14 @@ snapshots:
pathe@2.0.3: {}
+ pbf@4.0.2:
+ dependencies:
+ resolve-protobuf-schema: 2.1.0
+
+ pbf@5.1.0:
+ dependencies:
+ resolve-protobuf-schema: 2.1.0
+
picocolors@1.1.1: {}
picomatch@2.3.2: {}
@@ -2790,6 +2962,8 @@ snapshots:
picocolors: 1.1.1
source-map-js: 1.2.1
+ potpack@2.1.0: {}
+
pretty-format@27.5.1:
dependencies:
ansi-regex: 5.0.1
@@ -2802,12 +2976,16 @@ snapshots:
object-assign: 4.1.1
react-is: 16.13.1
+ protocol-buffers-schema@3.6.1: {}
+
proxy-from-env@2.1.0: {}
punycode@2.3.1: {}
queue-microtask@1.2.3: {}
+ quickselect@3.0.0: {}
+
react-dom@19.2.5(react@19.2.5):
dependencies:
react: 19.2.5
@@ -2841,6 +3019,10 @@ snapshots:
require-from-string@2.0.2: {}
+ resolve-protobuf-schema@2.1.0:
+ dependencies:
+ protocol-buffers-schema: 3.6.1
+
resolve@1.22.11:
dependencies:
is-core-module: 2.16.1
@@ -3013,6 +3195,8 @@ snapshots:
fdir: 6.5.0(picomatch@4.0.4)
picomatch: 4.0.4
+ tinyqueue@3.0.0: {}
+
tinyrainbow@3.1.0: {}
tldts-core@7.4.0: {}
diff --git a/frontend/src-tauri/Cargo.lock b/frontend/src-tauri/Cargo.lock
index b27376fb..20b5bc80 100644
--- a/frontend/src-tauri/Cargo.lock
+++ b/frontend/src-tauri/Cargo.lock
@@ -746,7 +746,7 @@ dependencies = [
[[package]]
name = "find-desktop"
-version = "0.0.1"
+version = "1.1.0"
dependencies = [
"serde",
"serde_json",
diff --git a/frontend/src-tauri/Cargo.toml b/frontend/src-tauri/Cargo.toml
index 996480a6..c894d7c7 100644
--- a/frontend/src-tauri/Cargo.toml
+++ b/frontend/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "find-desktop"
-version = "0.0.1"
+version = "1.1.0"
description = "Find - Local AI Image Intelligence desktop shell"
authors = []
edition = "2021"
diff --git a/frontend/src-tauri/tauri.conf.json b/frontend/src-tauri/tauri.conf.json
index 49c760ad..610595bd 100644
--- a/frontend/src-tauri/tauri.conf.json
+++ b/frontend/src-tauri/tauri.conf.json
@@ -1,6 +1,6 @@
{
"productName": "Find",
- "version": "0.0.1",
+ "version": "1.1.0",
"identifier": "com.abhashchakraborty.find",
"build": {
"beforeDevCommand": "pnpm dev",
From 5315afe03729f9e5af93f0a7d2cc64273aafbec2 Mon Sep 17 00:00:00 2001
From: Abhash Chakraborty
<80592559+Abhash-Chakraborty@users.noreply.github.com>
Date: Mon, 13 Jul 2026 02:11:07 +0530
Subject: [PATCH 04/21] ci: validate and publish modular release profiles
---
.github/workflows/ci.yml | 58 +++++++-
.github/workflows/manual-ghcr-publish.yml | 128 ------------------
.github/workflows/publish.yml | 157 ++++++++++++++++++++++
.github/workflows/testsprite.yml | 8 +-
4 files changed, 212 insertions(+), 139 deletions(-)
delete mode 100644 .github/workflows/manual-ghcr-publish.yml
create mode 100644 .github/workflows/publish.yml
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index e528f1ac..de7b10a0 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -7,17 +7,41 @@ name: CI
# frontend/** | yes | no | no
# backend/** | no | yes | no
# .github/workflows/** | yes | yes | yes
-# docker-compose*.yml | yes | yes | yes
+# compose*.yml | yes | yes | yes
# root/shared non-doc config | yes | yes | no
# docs/**, *.md, ISSUE_TEMPLATE | no | no | no
on:
+ workflow_dispatch:
push:
branches: ["main"]
pull_request:
branches: ["main"]
+permissions:
+ contents: read
+
+concurrency:
+ group: ci-${{ github.workflow }}-${{ github.ref }}
+ cancel-in-progress: true
+
jobs:
+ reference-boundary:
+ name: Reference source boundary
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+ with:
+ persist-credentials: false
+
+ - name: Reject tracked reference source
+ shell: bash
+ run: |
+ if [[ -n "$(git ls-files -- 'reference-app/**' '@reference-app/**')" ]]; then
+ echo "Reference application source must stay local and untracked." >&2
+ exit 1
+ fi
+
detect-changes:
runs-on: ubuntu-latest
outputs:
@@ -40,7 +64,7 @@ jobs:
- 'backend/**'
shared:
- '.github/workflows/**'
- - 'docker-compose*.yml'
+ - 'compose*.yml'
- uses: dorny/paths-filter@fbd0ab8f3e69293af611ebaee6363fc25e6d187d
id: uncategorized
@@ -52,7 +76,7 @@ jobs:
- '!frontend/**'
- '!backend/**'
- '!.github/workflows/**'
- - '!docker-compose*.yml'
+ - '!compose*.yml'
- '!docs/**'
- '!**/*.md'
- '!LICENSE'
@@ -193,13 +217,33 @@ jobs:
needs: detect-changes
if: needs.detect-changes.outputs.shared == 'true'
runs-on: ubuntu-latest
+ timeout-minutes: 10
+ strategy:
+ fail-fast: false
+ matrix:
+ file:
+ - compose.yml
+ - compose.base.yml
+ - compose.no-ai.yml
+ - compose.mock.yml
+ - compose.cpu.yml
steps:
- uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
with:
persist-credentials: false
- - name: Validate docker-compose.yml
- run: docker compose config --quiet
+ - name: Validate ${{ matrix.file }}
+ run: docker compose --env-file .env.example -f "${{ matrix.file }}" config --quiet
- - name: Validate docker-compose.light.yml
- run: docker compose -f docker-compose.light.yml config --quiet
+ dependency-review:
+ if: github.event_name == 'pull_request'
+ runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ steps:
+ - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+ with:
+ persist-credentials: false
+ - uses: actions/dependency-review-action@a1d282b36b6f3519aa1f3fc636f609c47dddb294
+ with:
+ fail-on-severity: high
diff --git a/.github/workflows/manual-ghcr-publish.yml b/.github/workflows/manual-ghcr-publish.yml
deleted file mode 100644
index 8e8e5342..00000000
--- a/.github/workflows/manual-ghcr-publish.yml
+++ /dev/null
@@ -1,128 +0,0 @@
-name: Manual GHCR Publish
-
-on:
- workflow_dispatch:
- inputs:
- image_tag:
- description: "Image tag to publish"
- required: true
- default: "latest"
- backend_flavor:
- description: "Backend image flavor"
- required: true
- default: "light"
- type: choice
- options:
- - light
- - full-ml
-
-permissions:
- contents: read
- packages: write
-
-jobs:
- publish:
- name: Build and publish images from main
- runs-on: ubuntu-latest
- steps:
- - name: Check out main
- uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
- with:
- ref: main
- persist-credentials: false
-
- - name: Prepare image names
- id: names
- shell: bash
- env:
- IMAGE_TAG: ${{ inputs.image_tag }}
- BACKEND_FLAVOR: ${{ inputs.backend_flavor }}
- run: |
- owner="$(echo "${GITHUB_REPOSITORY_OWNER}" | tr '[:upper:]' '[:lower:]')"
- tag="${IMAGE_TAG}"
- if [[ ! "${tag}" =~ ^[A-Za-z0-9._-]+$ ]]; then
- echo "image_tag may only contain letters, numbers, dots, underscores, and dashes." >&2
- exit 1
- fi
- sha_tag="main-$(git rev-parse --short=12 HEAD)"
- if [ "${BACKEND_FLAVOR}" = "full-ml" ]; then
- backend_tags="ghcr.io/${owner}/find-backend:${tag}-full-ml,ghcr.io/${owner}/find-backend:${sha_tag}-full-ml,ghcr.io/${owner}/find-backend:full-ml"
- else
- backend_tags="ghcr.io/${owner}/find-backend:${tag},ghcr.io/${owner}/find-backend:${sha_tag},ghcr.io/${owner}/find-backend:latest"
- fi
- {
- echo "backend_image=ghcr.io/${owner}/find-backend"
- echo "web_image=ghcr.io/${owner}/find-web"
- echo "backend_tags=${backend_tags}"
- echo "web_tags=ghcr.io/${owner}/find-web:${tag},ghcr.io/${owner}/find-web:${sha_tag},ghcr.io/${owner}/find-web:latest"
- } >> "$GITHUB_OUTPUT"
-
- - name: Set up Docker Buildx
- uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f
-
- - name: Log in to GHCR
- uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9
- with:
- registry: ghcr.io
- username: ${{ github.actor }}
- password: ${{ secrets.GITHUB_TOKEN }}
-
- - name: Build and push lightweight backend image
- if: inputs.backend_flavor == 'light'
- uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8
- with:
- context: ./backend
- file: ./backend/Dockerfile
- push: true
- platforms: linux/amd64,linux/arm64
- build-args: |
- BASE_IMAGE=python:3.12-slim
- PYTHON_VERSION=3.12
- UV_SYNC_EXTRAS=
- tags: ${{ steps.names.outputs.backend_tags }}
- labels: |
- org.opencontainers.image.source=https://github.com/${{ github.repository }}
- org.opencontainers.image.description=Find FastAPI backend, lightweight mock-mode image
-
- - name: Build and push full ML backend image
- if: inputs.backend_flavor == 'full-ml'
- uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8
- with:
- context: ./backend
- file: ./backend/Dockerfile
- push: true
- platforms: linux/amd64
- build-args: |
- BASE_IMAGE=nvidia/cuda:12.1.1-runtime-ubuntu22.04
- PYTHON_VERSION=3.12
- UV_SYNC_EXTRAS=--extra ml
- tags: ${{ steps.names.outputs.backend_tags }}
- labels: |
- org.opencontainers.image.source=https://github.com/${{ github.repository }}
- org.opencontainers.image.description=Find FastAPI backend, full local ML image
-
- - name: Build and push web image
- uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8
- with:
- context: ./frontend
- file: ./frontend/Dockerfile
- target: production
- push: true
- platforms: linux/amd64,linux/arm64
- build-args: |
- NEXT_PUBLIC_API_URL=http://localhost:8000
- NEXT_PUBLIC_MINIO_URL=http://localhost:9200
- NEXT_PUBLIC_MINIO_BUCKET=images
- tags: ${{ steps.names.outputs.web_tags }}
- labels: |
- org.opencontainers.image.source=https://github.com/${{ github.repository }}
- org.opencontainers.image.description=Find Next.js web UI
-
- - name: Publish summary
- shell: bash
- env:
- BACKEND_TAGS: ${{ steps.names.outputs.backend_tags }}
- WEB_TAGS: ${{ steps.names.outputs.web_tags }}
- run: |
- echo "Published backend tags: ${BACKEND_TAGS}" >> "$GITHUB_STEP_SUMMARY"
- echo "Published web tags: ${WEB_TAGS}" >> "$GITHUB_STEP_SUMMARY"
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 00000000..197ed70a
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,157 @@
+name: Publish release images
+
+on:
+ push:
+ tags:
+ - "v*"
+ workflow_dispatch:
+ inputs:
+ image_tag:
+ description: "Image tag to publish"
+ required: true
+ default: "edge"
+ backend_profile:
+ description: "Profile to publish (tag releases publish every profile)"
+ required: true
+ default: "nvidia"
+ type: choice
+ options:
+ - no-ai
+ - mock
+ - cpu
+ - nvidia
+
+permissions:
+ contents: read
+ packages: write
+
+concurrency:
+ group: publish-${{ github.ref }}-${{ inputs.image_tag || github.ref_name }}
+ cancel-in-progress: false
+
+jobs:
+ metadata:
+ name: Resolve immutable image metadata
+ runs-on: ubuntu-latest
+ outputs:
+ owner: ${{ steps.meta.outputs.owner }}
+ tag: ${{ steps.meta.outputs.tag }}
+ sha_tag: ${{ steps.meta.outputs.sha_tag }}
+ profiles: ${{ steps.meta.outputs.profiles }}
+ steps:
+ - name: Check out the selected revision
+ uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+ with:
+ persist-credentials: false
+
+ - name: Resolve tags
+ id: meta
+ shell: bash
+ env:
+ REQUESTED_TAG: ${{ inputs.image_tag }}
+ REQUESTED_PROFILE: ${{ inputs.backend_profile }}
+ run: |
+ owner="$(echo "${GITHUB_REPOSITORY_OWNER}" | tr '[:upper:]' '[:lower:]')"
+ tag="${REQUESTED_TAG:-${GITHUB_REF_NAME#v}}"
+ if [[ ! "${tag}" =~ ^[A-Za-z0-9._-]+$ ]]; then
+ echo "Image tag contains unsupported characters." >&2
+ exit 1
+ fi
+ echo "owner=${owner}" >> "$GITHUB_OUTPUT"
+ echo "tag=${tag}" >> "$GITHUB_OUTPUT"
+ echo "sha_tag=sha-$(git rev-parse --short=12 HEAD)" >> "$GITHUB_OUTPUT"
+ if [ "${GITHUB_EVENT_NAME}" = "push" ]; then
+ echo 'profiles=["no-ai","mock","cpu","nvidia"]' >> "$GITHUB_OUTPUT"
+ else
+ echo "profiles=[\"${REQUESTED_PROFILE}\"]" >> "$GITHUB_OUTPUT"
+ fi
+
+ backend:
+ name: Publish backend (${{ matrix.profile }})
+ needs: metadata
+ runs-on: ubuntu-latest
+ strategy:
+ fail-fast: false
+ matrix:
+ profile: ${{ fromJSON(needs.metadata.outputs.profiles) }}
+ steps:
+ - name: Check out source
+ uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+ with:
+ persist-credentials: false
+
+ - name: Set up QEMU
+ if: matrix.profile != 'nvidia'
+ uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130
+
+ - name: Set up Docker Buildx
+ uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f
+
+ - name: Log in to GHCR
+ uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9
+ with:
+ registry: ghcr.io
+ username: ${{ github.actor }}
+ password: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Build and publish profile
+ uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8
+ with:
+ context: ./backend
+ file: ./backend/Dockerfile
+ push: true
+ platforms: ${{ matrix.profile == 'nvidia' && 'linux/amd64' || 'linux/amd64,linux/arm64' }}
+ build-args: |
+ BASE_IMAGE=${{ matrix.profile == 'nvidia' && 'nvidia/cuda:12.1.1-runtime-ubuntu22.04' || 'python:3.12-slim' }}
+ PYTHON_VERSION=3.12
+ UV_SYNC_EXTRAS=${{ matrix.profile != 'no-ai' && format('--extra {0}', matrix.profile) || '' }}
+ FIND_BUILD_PROFILE=${{ matrix.profile }}
+ tags: |
+ ghcr.io/${{ needs.metadata.outputs.owner }}/find-backend:${{ needs.metadata.outputs.tag }}-${{ matrix.profile }}
+ ghcr.io/${{ needs.metadata.outputs.owner }}/find-backend:${{ needs.metadata.outputs.sha_tag }}-${{ matrix.profile }}
+ ghcr.io/${{ needs.metadata.outputs.owner }}/find-backend:${{ matrix.profile }}
+ labels: |
+ org.opencontainers.image.source=https://github.com/${{ github.repository }}
+ org.opencontainers.image.revision=${{ github.sha }}
+ org.opencontainers.image.version=${{ needs.metadata.outputs.tag }}
+ io.find.runtime.profile=${{ matrix.profile }}
+
+ web:
+ name: Publish web image
+ needs: metadata
+ runs-on: ubuntu-latest
+ steps:
+ - name: Check out source
+ uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
+ with:
+ persist-credentials: false
+
+ - name: Set up QEMU
+ uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130
+
+ - name: Set up Docker Buildx
+ uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f
+
+ - name: Log in to GHCR
+ uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9
+ with:
+ registry: ghcr.io
+ username: ${{ github.actor }}
+ password: ${{ secrets.GITHUB_TOKEN }}
+
+ - name: Build and publish web
+ uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8
+ with:
+ context: ./frontend
+ file: ./frontend/Dockerfile
+ target: production
+ push: true
+ platforms: linux/amd64,linux/arm64
+ tags: |
+ ghcr.io/${{ needs.metadata.outputs.owner }}/find-web:${{ needs.metadata.outputs.tag }}
+ ghcr.io/${{ needs.metadata.outputs.owner }}/find-web:${{ needs.metadata.outputs.sha_tag }}
+ ghcr.io/${{ needs.metadata.outputs.owner }}/find-web:latest
+ labels: |
+ org.opencontainers.image.source=https://github.com/${{ github.repository }}
+ org.opencontainers.image.revision=${{ github.sha }}
+ org.opencontainers.image.version=${{ needs.metadata.outputs.tag }}
diff --git a/.github/workflows/testsprite.yml b/.github/workflows/testsprite.yml
index 9cf6fce5..3bb82b87 100644
--- a/.github/workflows/testsprite.yml
+++ b/.github/workflows/testsprite.yml
@@ -61,7 +61,7 @@ jobs:
steps.testsprite-secret.outputs.available == 'true' &&
(github.event_name == 'pull_request' || github.event.inputs.base_url == '')
run: |
- docker compose -f docker-compose.light.yml up -d --build --wait --wait-timeout 240
+ docker compose -f compose.mock.yml up -d --build --wait --wait-timeout 240
- name: Wait for local preview
if: >
@@ -75,8 +75,8 @@ jobs:
fi
sleep 2
done
- docker compose -f docker-compose.light.yml ps
- docker compose -f docker-compose.light.yml logs --tail=120
+ docker compose -f compose.mock.yml ps
+ docker compose -f compose.mock.yml logs --tail=120
exit 1
- name: Run TestSprite
@@ -89,4 +89,4 @@ jobs:
- name: Stop local preview stack
if: always()
- run: docker compose -f docker-compose.light.yml down -v --remove-orphans
+ run: docker compose -f compose.mock.yml down -v --remove-orphans
From 16bd8d273f701654459142e381408329432c187c Mon Sep 17 00:00:00 2001
From: Abhash Chakraborty
<80592559+Abhash-Chakraborty@users.noreply.github.com>
Date: Mon, 13 Jul 2026 02:11:15 +0530
Subject: [PATCH 05/21] docs: prepare the v1.1 release candidate
---
.gitignore | 1 -
AGENTS.md | 4 +-
CHANGELOG.md | 33 ++-
CONTRIBUTING.md | 18 +-
GSSOC_CONTRIBUTOR_GUIDE.md | 14 +-
README.md | 78 ++++--
docs/guides/common-setup-errors.md | 2 +-
docs/guides/hardware-acceleration.md | 28 ++-
docs/guides/testsprite-ci.md | 2 +-
.../inventory/lane-a-timeline-grid.md | 131 -----------
.../inventory/lane-b-albums-sharing.md | 99 --------
.../lane-c-archive-favorites-trash.md | 106 ---------
.../inventory/lane-d-viewer-slideshow.md | 183 ---------------
docs/overhaul/inventory/lane-e-backend-api.md | 208 ----------------
docs/overhaul/inventory/lane-f-ml.md | 108 ---------
docs/overhaul/inventory/lane-g-settings.md | 222 ------------------
.../inventory/lane-h-mobile-desktop.md | 52 ----
.../not-started/desktop-runtime-comparison.md | 2 +-
docs/plans/not-started/remote-acceleration.md | 2 +-
.../storage-provider-neutrality-adr.md | 8 +-
plan.md | 62 +++--
21 files changed, 188 insertions(+), 1175 deletions(-)
delete mode 100644 docs/overhaul/inventory/lane-a-timeline-grid.md
delete mode 100644 docs/overhaul/inventory/lane-b-albums-sharing.md
delete mode 100644 docs/overhaul/inventory/lane-c-archive-favorites-trash.md
delete mode 100644 docs/overhaul/inventory/lane-d-viewer-slideshow.md
delete mode 100644 docs/overhaul/inventory/lane-e-backend-api.md
delete mode 100644 docs/overhaul/inventory/lane-f-ml.md
delete mode 100644 docs/overhaul/inventory/lane-g-settings.md
delete mode 100644 docs/overhaul/inventory/lane-h-mobile-desktop.md
diff --git a/.gitignore b/.gitignore
index 9d99e56d..caef8155 100644
--- a/.gitignore
+++ b/.gitignore
@@ -74,4 +74,3 @@ minio_data/
# Local reference copy of the AGPL-3.0 reference project — reference only, never committed
reference-app/
-immich/
diff --git a/AGENTS.md b/AGENTS.md
index 99f327da..b662e8c7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -31,7 +31,7 @@ Find is a local-first AI image intelligence app. Key paths:
- `backend/src/find_api/` - FastAPI API, SQLAlchemy models, Redis/RQ jobs, MinIO helpers, and ML wrappers.
- `frontend/src/app/` - Next.js App Router UI.
- `frontend/src/lib/` - React Query API client, media URL helpers, and shared utilities.
-- `docker-compose.yml` - PostgreSQL/pgvector, Redis, MinIO, API, worker, and web orchestration.
+- `compose.yml` and `compose.*.yml` - modular PostgreSQL, storage, API, worker, web, and AI profiles.
- `.env.example` - documented local configuration. Keep real `.env` files private.
- `.github/workflows/ci.yml` - frontend and backend CI checks.
@@ -78,7 +78,7 @@ Run the API and worker separately when not using Docker.
Prefer the light stack for routine UI, API, docs, and workflow work:
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
Use the full stack only when the change needs real ML behavior.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9bb7f4db..317de847 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,15 +4,38 @@ All notable changes to Find are documented here. The format is based on
[Keep a Changelog](https://keepachangelog.com/), and this project is
distributed under AGPL-3.0 (see `LICENSE` / `NOTICE`).
-## [Unreleased] — App overhaul (`feat/app-overhaul`)
+## [1.1.0] — 2026-07-13
-A large feature overhaul bringing reference-grade browsing, albums, sharing,
-archive/trash, and a hardware-acceleration layer. All changes below are on the
-`feat/app-overhaul` branch and verified by the test suites (backend pytest +
-frontend vitest) with a clean `tsc --noEmit` and `ruff check`.
+A product and platform overhaul bringing timeline-first browsing, account and
+vault management, a private offline map, modular AI artifacts, and a polished
+responsive application shell.
### Added
+**Application shell and account**
+- Responsive sidebar/top bar, focus-safe mobile navigation, global search
+ shortcut, theme persistence, and consistent route-level spacing.
+- Setup, login, profile, password rotation, active-session listing, and session
+ revocation backed by secure HTTP-only session cookies.
+
+**Private map and vault**
+- Opt-in EXIF GPS retention with an account-scoped offline MapLibre view using
+ bundled Natural Earth geometry and no external tile or geocoding requests.
+- Explicit vault session locking, session-only decrypted thumbnails, timeline
+ browsing, full-screen preview, and rollback-safe restoration.
+
+**Modular runtime**
+- Separate no-AI, mock, CPU, and NVIDIA dependency artifacts. CPU/no-AI builds
+ do not install CUDA packages; the dashboard reports the installed artifact,
+ applied mode, worker health, and restart requirements.
+- Dashboard selection of disabled, mock, or full processing whenever that mode
+ is installed in the active artifact, without restarting or downloading a
+ different dependency stack.
+- Consolidated Compose topology: `compose.yml`, `compose.base.yml`, and explicit
+ `compose.no-ai.yml`, `compose.mock.yml`, and `compose.cpu.yml` profiles.
+- Tag-driven and manual GHCR publishing for immutable web images and all four
+ modular backend profiles.
+
**Timeline**
- Month-bucketed timeline API: `GET /api/timeline/buckets` (counts per month)
and `GET /api/timeline/bucket` (columnar per-asset window with aspect ratio).
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 14d6432d..ed78c0cc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -35,7 +35,7 @@ For repo-aware coding-agent and contributor guidance, start with [AGENTS.md](./A
For most UI, API, docs, and workflow contributions, start with the light stack:
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
This uses `ML_MODE=mock`, skips GPU access, and avoids downloading Florence-2, SigLIP, PaddleOCR, YOLO, and CUDA PyTorch assets. Upload, worker processing, gallery, search, and clustering still run end-to-end with deterministic mock metadata and vectors.
@@ -46,9 +46,15 @@ Use the full stack only when your change needs real ML inference:
docker compose up --build
```
+On a machine without NVIDIA support, use the locked CPU-only AI artifact:
+
+```bash
+docker compose -f compose.cpu.yml up --build
+```
+
## Mock mode vs full ML mode
-The light stack (`docker-compose.light.yml`) runs with `ML_MODE=mock`. The worker
+The mock stack (`compose.mock.yml`) runs with `ML_MODE=mock`. The worker
records real image dimensions and EXIF data but replaces all model outputs with
deterministic stubs:
@@ -60,7 +66,7 @@ deterministic stubs:
### When the light stack is enough
-Use `docker-compose.light.yml` (mock mode) when your change involves:
+Use `compose.mock.yml` when your change involves:
- Any frontend code (UI, layout, styling, components)
- API routing, request/response shapes, validation, or error handling
@@ -98,7 +104,8 @@ uv sync --group dev
uv run uvicorn find_api.main:app --reload
```
-Use `uv sync --group dev --extra ml` only when you need real local ML inference outside Docker.
+Use `uv sync --group dev --extra cpu` for real CPU inference outside Docker or
+`uv sync --group dev --extra nvidia` for CUDA. Do not enable both extras.
Worker:
@@ -213,4 +220,5 @@ Useful labels:
## License
-By contributing, you agree your contributions are licensed under the [MIT License](./LICENSE).
+By contributing, you agree your contributions are licensed under the
+[GNU Affero General Public License v3.0](./LICENSE).
diff --git a/GSSOC_CONTRIBUTOR_GUIDE.md b/GSSOC_CONTRIBUTOR_GUIDE.md
index 42b5705b..8bf056c6 100644
--- a/GSSOC_CONTRIBUTOR_GUIDE.md
+++ b/GSSOC_CONTRIBUTOR_GUIDE.md
@@ -27,8 +27,8 @@ Important paths:
- `frontend/src/app/` - Next.js pages and UI.
- `frontend/src/lib/` - frontend API client and shared helpers.
- `backend/src/find_api/` - FastAPI app, routers, models, storage, queue, worker, and ML wrappers.
-- `docker-compose.yml` - full GPU-oriented stack.
-- `docker-compose.light.yml` - lightweight contributor stack.
+- `compose.yml` - default NVIDIA GPU stack.
+- `compose.mock.yml` - lightweight contributor stack.
- `.env.example` - documented local environment values.
## Contribution workflow
@@ -49,7 +49,7 @@ Most GSSoC work should start with the light stack. It avoids the 30-40 GB first-
From the repository root:
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
What light mode gives you:
@@ -68,7 +68,7 @@ Use light mode for:
## Understanding mock mode output
-The light stack (`docker-compose.light.yml`) is the recommended starting point for all
+The mock stack (`compose.mock.yml`) is the recommended starting point for all
GSSoC contributors because it avoids large model downloads and GPU requirements.
However, it runs with `ML_MODE=mock`, and understanding what that means prevents a
common class of false bug reports.
@@ -120,7 +120,7 @@ docker compose up --build
> ⚠️ **Do not report caption or search quality issues observed in mock mode.**
>
-> If you ran `docker compose -f docker-compose.light.yml up --build` and noticed that
+> If you ran `docker compose -f compose.mock.yml up --build` and noticed that
> captions look wrong, search returns unrelated images, or objects are not detected —
> that is expected mock behavior and is not a bug. Open a full-stack environment and
> reproduce the issue there before filing a report or opening a PR that claims to fix
@@ -174,7 +174,7 @@ Real local ML dependencies:
```bash
cd backend
-uv sync --group dev --extra ml
+uv sync --group dev --extra cpu
```
Manual local setup also requires PostgreSQL with `pgvector`, Redis, and MinIO.
@@ -211,7 +211,7 @@ Compose validation:
```bash
docker compose config
-docker compose -f docker-compose.light.yml config
+docker compose -f compose.mock.yml config
```
## Manual testing checklist
diff --git a/README.md b/README.md
index 3b3bd58a..3a91196f 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ See the documentation index in [`docs/index.md`](./docs/index.md), the mobile di
- Inspect full-resolution images with zoom, keyboard navigation, and slideshow
- Share albums with scoped links and optional passwords/download controls
- Organize media with favorites, archive, recoverable trash, and near-duplicate review
-- Protect hidden images in an encrypted local vault; full design alignment remains in progress
+- Protect hidden images in an encrypted local vault with explicit in-memory sessions, timeline browsing, preview, restore, and lock controls
- Record local feedback for search, captions, objects, and people grouping
## Tech stack
@@ -43,16 +43,19 @@ See the documentation index in [`docs/index.md`](./docs/index.md), the mobile di
## Runtime profiles
-| Profile | Command | Intended use | ML behavior |
+| Artifact | Command | Included AI runtime | GPU/CUDA download |
| --- | --- | --- | --- |
-| Light | `docker compose -f docker-compose.light.yml up --build` | UI, API, docs, contributor work, and low-resource smoke tests | Deterministic mock inference; no model downloads or GPU required |
-| Full | `docker compose up --build` | Real caption, OCR, detection, embedding, face, and search-quality validation | Downloads the configured local models and currently expects NVIDIA GPU support |
-
-The full profile is intentionally much larger because it includes CUDA PyTorch,
-PaddleOCR/PaddlePaddle, ONNX Runtime, Florence-2, SigLIP, YOLO26 nano, and
-InsightFace. Use the light profile unless the change specifically needs real ML
-quality or hardware measurements. Model-size and CPU-only packaging improvements
-are tracked in GitHub issues rather than silently changing model behavior.
+| No AI | `docker compose -f compose.no-ai.yml up --build` | None; thumbnails, dimensions, EXIF, gallery, albums, vault, and maps remain available | No |
+| Mock | `docker compose -f compose.mock.yml up --build` | Deterministic test metadata/vectors | No |
+| CPU AI | `docker compose -f compose.cpu.yml up --build` | Real local captioning, OCR, detection, embeddings, faces, and clustering with CPU PyTorch/ONNX | No |
+| NVIDIA AI | `docker compose up --build` | Real local AI with CUDA PyTorch/ONNX providers | Yes |
+
+The default `compose.yml` is the NVIDIA profile. Explicit profiles extend
+`compose.base.yml`, keeping application and data services centralized while
+each backend image installs only its selected dependency extra. Selecting a
+profile is a build/deployment choice;
+the dashboard can enable/disable installed AI and choose Auto/GPU/CPU, but it
+cannot install missing packages into a running container.
## Architecture
@@ -116,14 +119,27 @@ Services:
Notes:
- Current Docker setup is GPU-oriented and expects NVIDIA GPU access.
-- If no root `.env` is present, compose defaults support local demo startup.
+- Copy `.env.example` to `.env` before startup. Compose intentionally has no
+ embedded service-password fallback.
+
+For the same real local AI pipeline without CUDA or an NVIDIA runtime, use:
+
+```bash
+docker compose -f compose.cpu.yml up --build
+```
+
+For metadata-only operation with no AI dependencies or model downloads, use:
+
+```bash
+docker compose -f compose.no-ai.yml up --build
+```
### Option B: fast contributor mode (recommended for most work)
For UI, API, upload, gallery, search, clustering, docs, and workflow changes, use the light stack:
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
This runs the same app flow with `ML_MODE=mock`, a Python slim backend image, and no GPU/model cache mount. It avoids downloading Florence-2, SigLIP, PaddleOCR, YOLO, CUDA PyTorch, and related model weights, so first-time setup is much smaller and faster.
@@ -142,7 +158,7 @@ Find ships two runtime modes that serve different purposes. Choosing the wrong o
### Mock mode (light stack)
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
`ML_MODE=mock` is set automatically. The worker skips all model loading and instead records:
@@ -199,6 +215,34 @@ The worker loads Florence-2 (captioning), YOLOv10 (object detection), PaddleOCR
First run of the full stack downloads Florence-2, SigLIP, PaddleOCR, and YOLO weights (several GB). Models are cached in the `model_cache` Docker volume and reused on subsequent runs.
+## Controlling AI from the dashboard
+
+The account/settings dashboard persists four instance-wide runtime choices:
+
+- `ai_enabled` turns the installed AI pipeline on or off.
+- `ml_mode` switches between the modes already present in the artifact. CPU and
+ NVIDIA builds can move directly between disabled, mock, and full local AI;
+ lightweight builds never pretend that missing model packages are available.
+- `accel_mode` selects `auto`, `gpu`, or `cpu`; unsupported GPU requests fall
+ back to CPU inside CPU/NVIDIA artifacts.
+- `map_enabled` opts in to retaining GPS coordinates from EXIF for the private map.
+
+Workers read all three values at the start of every job, so new jobs use the
+saved choice without mutating a worker's process environment. Inspect
+`GET /api/config/runtime` to compare the selected build/mode with the last state
+actually applied by a worker. If that endpoint says `restart_required: true`,
+start the CPU or NVIDIA compose artifact; a no-AI/mock image cannot become a
+full image through a toggle.
+
+Release tags (`v*`) publish immutable web images plus separate `no-ai`, `mock`,
+`cpu`, and `nvidia` backend images through `.github/workflows/publish.yml`.
+Manual runs can publish one selected profile without building unrelated AI
+dependencies.
+
+`ML_MODE=remote` is intentionally fail-closed for now: no remote inference
+adapter is installed, the runtime reports `unavailable`, and Find never sends
+private media to a remote service or silently falls back to local models.
+
### Option C: local development without Docker
#### Prerequisites
@@ -225,7 +269,9 @@ uv sync --group dev
uv run uvicorn find_api.main:app --reload
```
-Use `uv sync --group dev --extra ml` only when you need real local ML inference outside Docker.
+Use `uv sync --group dev --extra cpu` for real CPU inference outside Docker, or
+`uv sync --group dev --extra nvidia` for the locked CUDA build. The two extras
+are intentionally mutually exclusive.
#### 3. Worker (separate terminal)
@@ -365,7 +411,7 @@ docker compose logs --tail=200 api
- Model downloads happen on the first startup of the full stack.
- Cached models are stored in the Docker volume mounted at `model_cache`.
-- Use `docker compose -f docker-compose.light.yml up --build` when you only need to test contributor changes without real ML inference.
+- Use `docker compose -f compose.mock.yml up --build` when you only need to test contributor changes without real ML inference.
### Docker disk usage
@@ -387,7 +433,7 @@ docker compose exec api sh -lc "rm -rf /root/.cache/uv"
- Prefer the light stack for routine UI/API/docs work when you do not need real inference:
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
## Contribution quick start
diff --git a/docs/guides/common-setup-errors.md b/docs/guides/common-setup-errors.md
index 0c0b8efb..4b76aef0 100644
--- a/docs/guides/common-setup-errors.md
+++ b/docs/guides/common-setup-errors.md
@@ -152,7 +152,7 @@ Expected ports:
Use the light Docker stack for routine contributor work:
```bash
-docker compose -f docker-compose.light.yml up --build
+docker compose -f compose.mock.yml up --build
```
- Use the full stack only when testing real ML inference, captions, OCR, search
diff --git a/docs/guides/hardware-acceleration.md b/docs/guides/hardware-acceleration.md
index 595e9c3e..03e6605d 100644
--- a/docs/guides/hardware-acceleration.md
+++ b/docs/guides/hardware-acceleration.md
@@ -72,18 +72,36 @@ ACCEL_MODE=auto
Or change it at runtime from **Settings → Hardware acceleration**.
+The dashboard preference is persisted in `app_settings` and sampled at each
+API inference request/worker job boundary. `GET /api/config/runtime` reports
+both the desired state and the last state a worker actually applied.
+
### Legacy `USE_GPU`
Earlier versions used a boolean `USE_GPU`. For backward compatibility,
`USE_GPU=false` is still honored as a hard CPU pin when `ACCEL_MODE` is left at
`auto`. New deployments should prefer `ACCEL_MODE`.
-## CPU-only deployments
+## Install-time profiles
+
+Acceleration fallback cannot remove CUDA packages that were already baked into
+an image, so Find provides separate locked artifacts:
+
+```bash
+# Real AI with CPU-only PyTorch and ONNX Runtime; no CUDA wheels.
+docker compose -f compose.cpu.yml up --build
+
+# Real AI with CUDA PyTorch and onnxruntime-gpu.
+docker compose up --build
+
+# Deterministic fake inference, or metadata-only with no AI extra at all.
+docker compose -f compose.mock.yml up --build
+docker compose -f compose.no-ai.yml up --build
+```
-On a machine with no GPU, no configuration is required — `auto` resolves to CPU
-and the full pipeline runs. For the lightest footprint, set `ACCEL_MODE=cpu`
-explicitly. (CPU-friendly model variants such as a quantized embedding model are
-tracked as a follow-on; the current models run on CPU, just slower than on GPU.)
+Choose the CPU artifact on a machine without an NVIDIA runtime. Setting
+`ACCEL_MODE=cpu` in an NVIDIA image changes execution but does not shrink that
+image; conversely, setting `gpu` in a CPU image cannot install CUDA packages.
## Troubleshooting
diff --git a/docs/guides/testsprite-ci.md b/docs/guides/testsprite-ci.md
index a8e08984..d078a018 100644
--- a/docs/guides/testsprite-ci.md
+++ b/docs/guides/testsprite-ci.md
@@ -19,7 +19,7 @@ to the repository.
- The workflow triggers on pull requests to `main`.
- Draft pull requests are skipped.
- Every non-draft PR is tested when the TestSprite secret is available.
-- App PRs start `docker-compose.light.yml` in GitHub Actions.
+- App PRs start `compose.mock.yml` in GitHub Actions.
- The light stack runs in mock ML mode, so it avoids GPU/model downloads.
- TestSprite is pointed at `http://127.0.0.1:3000`.
diff --git a/docs/overhaul/inventory/lane-a-timeline-grid.md b/docs/overhaul/inventory/lane-a-timeline-grid.md
deleted file mode 100644
index 427a2664..00000000
--- a/docs/overhaul/inventory/lane-a-timeline-grid.md
+++ /dev/null
@@ -1,131 +0,0 @@
-# Lane A — Timeline & Grid Inventory
-
-Scope: justified grid layout, fast date-scrubber scrollbar, segment/bucket preview, virtualized rendering.
-Reference app: `reference-app/web/src/lib/` (Svelte 5 runes + Immich-style SDK). Read-only.
-
----
-
-## 1. Behaviors
-
-Justified grid layout
-- Per-row justified layout from per-asset aspect ratios; ratios packed into a `Float32Array`, fed to either a WASM layout engine or the JS `justified-layout` lib. Options: target `rowHeight`, container `rowWidth`, `spacing`, `heightTolerance`. `layout-utils.ts:30-116`.
-- Layout exposes a box-geometry interface (`getTop/getLeft/getWidth/getHeight/getPosition(boxIdx)`, `containerWidth/Height`) so render code positions each tile absolutely. `layout-utils.ts:13-21`.
-- Two-level layout: each **month** lays out its **day groups** independently, then day groups are flowed into rows within the month, wrapping when `cumulativeWidth + itemWidth > viewportWidth`, accumulating `month.height`. Each day group carries `row/col/start(left)/top`. `layout-support.svelte.ts:23-70`.
-- Default tunables: `rowHeight=235`, `headerHeight=48`, `gap=12`, `spacing=2`, `heightTolerance=0.5`. `VirtualScrollManager.svelte.ts:22-34,145`.
-
-Height estimation before load (skeleton geometry)
-- For not-yet-loaded months, height is *estimated* without real ratios: `unwrappedWidth = 1.5 * assetCount * rowHeight * 0.7`, `rows = ceil(unwrappedWidth / viewportWidth)`, `height = headerHeight + max(1,rows)*rowHeight`. This lets the full scroll height + scrubber exist before any bucket is fetched. `layout-support.svelte.ts:10-19`.
-
-Virtualized rendering (windowing)
-- Total scroll height = `topSectionHeight + bodySectionHeight + bottomSectionHeight`; `bodySectionHeight` = sum of all `month.height`. `VirtualScrollManager.svelte.ts:12`, `timeline-manager.svelte.ts:53-59`.
-- A `visibleWindow {top,bottom}` derives from `scrollTop` + `viewportHeight`. `VirtualScrollManager.svelte.ts:14-17`.
-- Each month gets a `ViewportProximity` of `InViewport | NearViewport | FarFromViewport`, computed by intersecting `[month.top, month.top+height]` against the window expanded by `INTERSECTION_EXPAND_TOP/BOTTOM` tunables. Only in/near months are laid out for real and rendered; far months keep estimated height only. `intersection-support.svelte.ts:31-55`.
-- Scroll handler updates the sliding window (`updateSlidingWindow`) which recomputes proximities only when `scrollTop` actually changed. `VirtualScrollManager.svelte.ts:155-161`.
-- Deferred layout: far months defer real justified layout; cleared (`clearDeferredLayout`) when they come near viewport. `intersection-support.svelte.ts:52-54`.
-
-Lazy data load per month (buckets)
-- Months are created empty from a bucket-count list at init (count only, no assets). `timeline-manager.svelte.ts:247-266`.
-- Asset detail for a month is fetched on demand via `loadTimelineMonth` → `loadFromTimeBuckets` when the month enters/nears the viewport (or is iterated). Each fetch is a `CancellableTask` so off-screen loads can abort. `timeline-manager.svelte.ts:351-372`, `load-support.svelte.ts:8-60`.
-- On successful load, real geometry is computed and proximities refreshed. `timeline-manager.svelte.ts:368-371`.
-
-Scrub-to-date scrollbar (the fast scrubber)
-- Scrubber renders one **segment per month**, segment height proportional to that month's share of total scroll height (`month.height / scrubberTimelineHeight`). `Scrubber.svelte:144-192`, `timeline-manager.svelte.ts:340-349`.
-- Sparse labels/dots: walking months newest→oldest, a year label is placed only when the year changes AND accumulated span > `MIN_YEAR_LABEL_DISTANCE(16px)`; a dot only when segment >5px tall and span > `MIN_DOT_DISTANCE(8px)`. Prevents label crowding. `Scrubber.svelte:144-192`.
-- Has lead-in (top offset / header) and lead-out (bottom) pseudo-segments. `Scrubber.svelte:100-126`, `Timeline.svelte:333-340`.
-- Two-way binding: (a) dragging/hovering the scrubber → `onScrub` callback maps the cursor's segment + intra-segment percent to a `scrollTop` and calls `timelineManager.scrollTo`. `Timeline.svelte:268-307`. (b) on normal scroll, the timeline computes which month is at the viewport top and the percent through it (`viewportTopMonth`, `viewportTopMonthScrollPercent`) and feeds the scrubber thumb position. `Timeline.svelte:316-363`, `Scrubber.svelte:95-129`.
-- Hover shows a floating date label for the segment under the cursor; padding zones above/below clamp to first/last month label. `Scrubber.svelte:195-243`.
-- Mobile vs desktop: scrubber width 20px (mobile, only visible while scrolling) vs 60px (desktop); widens to full viewport while dragging. `Scrubber.svelte:71-90`.
-- "limitedScroll" edge case (content barely taller than viewport, `maxScrollPercent < 0.5`): falls back to a single overall scroll percent instead of per-month mapping. `timeline-manager.svelte.ts:76`, `Timeline.svelte:316-322`.
-
-Scroll-to-asset / scroll-to-date
-- Programmatic scroll to a given asset: find its month, ensure loaded, compute box top/bottom, scroll to whichever of align-top/align-bottom is nearer. `Timeline.svelte:128-197`.
-- Random/jump-to-date loads the target month then scrolls. `timeline-manager.svelte.ts:412-442`.
-
-Multi-select
-- Selection state: a `Map` plus selected day-groups set, `selectAll` flag, and `startAsset` for range anchoring. Derived flags: `selectionActive`, `isAllFavorite/Trashed/Archived/UserOwned`, `ownedAssets`. `asset-multi-select-manager.svelte.ts:10-105`.
-- Range/candidate selection: holding shift sets a start anchor; hovering computes a candidate range between anchor and current asset (`candidates`), committed on click. `asset-multi-select-manager.svelte.ts:83-93`, `Timeline.svelte:366-494` (shift handling at 474,494).
-- Reset on navigation event. `asset-multi-select-manager.svelte.ts:38-40`.
-
-Realtime updates
-- Websocket support upserts/updates/deletes assets into the right month, recomputing geometry; pending-change queue types Add/Update/Delete/Trash. `types.ts:55-75`, manager `connect()`/`upsertAssets` `timeline-manager.svelte.ts:172-178,374-377`.
-
----
-
-## 2. Data needs (endpoint contracts, abstract)
-
-The reference timeline rests on **two** contracts. Find currently has neither in this shape.
-
-A. Bucket-count list (the timeline skeleton) — REQUIRED, highest priority
-- Request: timeline filter params (owner/album/person/visibility/tag, sort order) + a bucket granularity (month).
-- Response: ordered list of `{ timeBucket: ISO-date (month start), count: number }`, sorted by the active order (newest- or oldest-first).
-- Purpose: lets the client build every month, estimate total scroll height, and render the full scrubber **before fetching a single photo**. This is what makes scrub-to-date instant. Used at `timeline-manager.svelte.ts:247-263`.
-
-B. Per-bucket asset window — REQUIRED
-- Request: same filter params + a single `timeBucket` (the month key) + size.
-- Response: the assets for exactly that month. Reference uses a columnar/struct-of-arrays bucket payload (parallel arrays keyed off the response) decoded into `TimelineAsset[]`. `load-support.svelte.ts:19-49`.
-- Per-asset fields the layout/UI actually need (`types.ts:18-41`): `id`, `ratio` (aspect ratio — **critical for justified layout**), `thumbhash` (blur placeholder), `localDateTime`, `isVideo/isImage`, `duration`, `isFavorite/isTrashed`, `visibility`, `ownerId`, optionally `city/country/people/lat/long`, stack info.
-
-Key contract note: granularity is **month buckets**, ordering is server-controlled and stable, and counts come separately from assets. The whole virtualization + scrubber design depends on knowing per-month counts up front.
-
----
-
-## 3. Find today + the gap
-
-What Find has (`frontend/src/components/virtualized-grid.tsx`, `app/gallery/page.tsx`, `store/galleryStore.ts`, `lib/api.ts`):
-- `VirtualizedGrid`: a CSS-grid windower. Reads `grid-template-columns` to count columns, assumes a **uniform** `estimateRowHeight + gap` row stride, computes start/end rows from `getBoundingClientRect().top` vs `window.innerHeight`, renders a top/bottom spacer + the visible slice. Listens to window + scroll-parent scroll/resize + ResizeObserver. `virtualized-grid.tsx:63-194`.
-- Data: offset pagination via `getGallery({page,limit,sortOrder,dateRange,dateStart,dateEnd})` → `GalleryResponse {items, total, page, limit}`, consumed with React Query `useInfiniteQuery` (page N+1 when `page*limit < total`). `api.ts:265-296`, `page.tsx:439-455`.
-- Sorting newest/oldest + a date-range *filter* (presets + custom start/end) already exist in `galleryStore` and the URL. `galleryStore.ts:4-26`, `api.ts:21-27`.
-- `MediaItem` has `width`/`height` (so aspect ratio is derivable) but **no thumbhash/blur placeholder, no per-asset localDate grouping field used client-side**. `api.ts:33-60`.
-- Counts endpoint exists but returns only status totals (`all/indexed/processing/failed`), **not per-date counts**. `api.ts:106-111,298-307`.
-
-GAP vs reference:
-1. **No justified layout.** Find uses a fixed-column square/uniform grid; reference packs variable-aspect rows. Tiles' real `width/height` are unused for layout.
-2. **No time-bucket data model.** Find paginates by offset/page; there's no month-bucket count list, so the full timeline height and the scrubber can't be known up front. This is the central architectural gap.
-3. **No date scrubber at all.** No fast scrub-to-date, no month segments, no hover-date preview, no scroll↔scrubber two-way sync.
-4. **No month/day headers or grouping** in the grid; reference groups by month and by day with sticky-ish headers and per-group geometry.
-5. **Uniform-height virtualization only.** Find's windower assumes every row is the same height; it cannot represent variable month heights or justified rows. It also relies on `window`/`getBoundingClientRect` rather than an owned scroll container with a derived sliding window.
-6. **No proximity/deferred-layout tier.** Find renders a flat slice; there's no "near vs far" distinction, no per-month lazy fetch, no cancellable off-screen loads.
-7. **Multi-select** exists in reference with range/shift + group selection; verify Find's gallery selection (not in scope files read) matches — at minimum range-by-shift and select-whole-day are reference behaviors to match.
-
----
-
-## 4. Port notes (Svelte 5 → React 19 / Next 16)
-
-State model
-- Reference leans on Svelte runes (`$state/$derived/$effect`) inside plain manager classes. In React, the cleanest port is a framework-agnostic `TimelineManager` plain class holding mutable geometry + a small store (Zustand, matching existing `galleryStore`) for the few reactive scalars the UI reads (`months`, `scrubberMonths`, `scrollTop`, `visibleWindow`, selection). Keep heavy geometry off React state; expose an imperative `subscribe`/snapshot so the grid reads positions without re-rendering every tile.
-
-Algorithms to reimplement (these are the load-bearing pieces)
-- Justified row packing from aspect ratios → box geometry. Use the `justified-layout` npm package (same one reference falls back to) rather than the WASM module to start; WASM is an optimization, not required. `layout-utils.ts:102-116`.
-- Two-level month→day-group flow + month height accumulation. `layout-support.svelte.ts:23-70`.
-- Pre-load height estimate formula (so the scrubber exists before fetch). `layout-support.svelte.ts:10-19`.
-- Viewport-proximity intersection with top/bottom expansion + deferred layout clearing. `intersection-support.svelte.ts:31-55`.
-- Scrubber segment building (sparse label/dot placement). `Scrubber.svelte:144-192`.
-- Bidirectional scroll↔scrubber mapping (segment+percent → scrollTop and viewport-top-month detection). `Timeline.svelte:268-363`, `Scrubber.svelte:95-129`.
-
-Virtualization approach
-- Own the scroll container (don't ride `window`). Absolute-position month sections at their cumulative `top`; within a section, absolute-position rows/tiles from box geometry. Render only In/Near months. Spacer-free since each section has an explicit height.
-- React 19 / Next 16: this is a client component (`"use client"`). Avoid `ResizeObserver`-driven full re-layouts on every scroll; throttle layout to width changes, and only recompute proximities (cheap) on scroll. The current `virtualized-grid.tsx`'s reliance on `getBoundingClientRect` per scroll should be replaced by reading the owned container's `scrollTop`.
-- thumbhash/blur placeholders need a decode util on the React side (or fall back to a CSS blur of `thumbnail_url`) if the backend can't emit thumbhash soon.
-
-Backend dependency
-- The month-bucket count endpoint and per-bucket asset endpoint must land in `lib/api.ts` + the Go/Python backend before the timeline can be built. This is the long pole and should be specced with the API/backend lane. Without it, only a degraded "estimate from total count" timeline is possible.
-
----
-
-## 5. Effort estimate (S/M/L)
-
-| Behavior | Size | Notes |
-|---|---|---|
-| Month-bucket count endpoint + per-bucket asset endpoint (backend + api.ts) | **L** | Blocking dependency; new data model + backend work |
-| Justified layout (ratios → box geometry) | **M** | Use `justified-layout` lib; ratio from `width/height` |
-| Two-level month→day-group flow + height accumulation | **M** | Direct port of layout-support |
-| Pre-load height estimation | **S** | One formula |
-| Owned-container virtualization + proximity tiers + deferred layout | **L** | Core rewrite of `virtualized-grid.tsx`; variable section heights |
-| Lazy per-month fetch with cancellable off-screen loads | **M** | Ties windowing to data layer |
-| Date scrubber: segments + sparse labels/dots | **M** | Port `calculateSegments` |
-| Scrubber ↔ scroll two-way sync (incl. limitedScroll edge case) | **M** | Fiddly mapping math |
-| Hover-date preview + mobile/desktop width behavior | **S** | UI polish on the scrubber |
-| Month/day headers + grouping | **S–M** | New render structure |
-| Multi-select range/shift + whole-group select | **M** | Confirm against Find's existing selection first |
-| thumbhash blur placeholders | **S** | Or CSS-blur fallback if no backend support |
-| Realtime websocket upsert into months | **M** | Only if Find has/plans websockets; otherwise defer |
diff --git a/docs/overhaul/inventory/lane-b-albums-sharing.md b/docs/overhaul/inventory/lane-b-albums-sharing.md
deleted file mode 100644
index 712696d5..00000000
--- a/docs/overhaul/inventory/lane-b-albums-sharing.md
+++ /dev/null
@@ -1,99 +0,0 @@
-# Lane B Inventory — Albums & Sharing
-
-Read-only discovery from `reference-app/` (Svelte web + NestJS server). Behavior/data-model/API-shape only; no verbatim source. Find currently has **no** albums or sharing primitives.
-
----
-
-## 1. Album behaviors
-
-- **Create** — album has a name (default `"Untitled Album"`), optional description, optional initial users (with roles) and initial asset IDs. Creating user becomes `owner` (enforced via a unique index allowing exactly one `owner` row per album). `reference-app/server/src/controllers/album.controller.ts:46`, `dtos/album.dto.ts:32` (CreateAlbumSchema), `schema/tables/album-user.table.ts:23` (`album_user_unique_owner`).
-- **List / get** — list all albums available to user, with filters: `id`, `name` (exact), `isOwned` (owned vs shared-with-me), `isShared`, `assetId` (albums containing an asset). Single-album get is also reachable via a shared link. `album.controller.ts:33,60`, `dtos/album.dto.ts:66` (GetAlbumsSchema).
-- **Update (metadata only)** — name, description, **cover** (`albumThumbnailAssetId`), `isActivityEnabled`, and `order` (asset sort). Explicitly not for adding/removing assets or users. `album.controller.ts:71`, `dtos/album.dto.ts:56` (UpdateAlbumSchema).
-- **Delete** — soft-delete (trashed via `deletedAt`) then background hard-delete. `album.controller.ts:88`, `schema/tables/album.table.ts:41` (`deletedAt`).
-- **Membership (assets)** — add assets to one album; add assets to many albums at once (`PUT /albums/assets` with album+asset ID lists); remove assets. Bulk responses report per-asset success/error (duplicate / no-permission). `album.controller.ts:111,126,138`, `dtos/album.dto.ts:42` (AlbumsAddAssetsSchema).
-- **Membership (users) / roles** — share album with users at a role; update a user's role; remove a user (use `me` to leave a shared album). `album.controller.ts:152,170,189`. Roles: `owner`, `editor`, `viewer` — `enum.ts:65`.
-- **Cover** — single nullable thumbnail asset FK, `ON DELETE SET NULL`. `schema/tables/album.table.ts:25`.
-- **Ordering** — album-level `order` enum (asc/desc by date); response derives `startDate`/`endDate` from member assets. `schema/tables/album.table.ts:48`, `dtos/album.dto.ts:175` (mapAlbum).
-- **Statistics** — counts of owned / shared / not-shared albums. `album.controller.ts:54`.
-- **Map markers** — per-album geo markers (shared-link accessible). `album.controller.ts:104`.
-- **Activity feed** — likes + comments on an album or on an asset-in-album, toggled by `isActivityEnabled`. Like is unique per (asset,user,album); a row is either a comment or a like (DB check constraint). Create/list/delete/statistics. `controllers/activity.controller.ts:30,46,66,78`, `schema/tables/activity.table.ts:24,28`.
-- **Response shape** — `albumUsers` ordered owner-first then auth-user then alphabetical; flags `shared`, `hasSharedLink`; `assetCount`. `dtos/album.dto.ts:108` (AlbumResponseSchema).
-
-## 2. Sharing behaviors
-
-### Shared links — `controllers/shared-link.controller.ts`, `services/shared-link.service.ts`, `dtos/shared-link.dto.ts`
-- **Two types** — `ALBUM` (shares a whole album) and `INDIVIDUAL` (a set of assets not necessarily in an album). `enum.ts:312`.
-- **Create** requires access check on the target: `AlbumShare` permission for album links, `AssetShare` for individual. A random 50-byte `key` is generated per link (base64url in responses). `shared-link.service.ts:68,93`.
-- **Per-link options** — `description`, `password` (optional), custom `slug` (unique), `expiresAt` (nullable), `allowUpload` (default false on table / true in create path), `allowDownload` (default true), `showMetadata`/`showExif` (default true). Rule: if `showMetadata=false` then `allowDownload` is forced false. `dtos/shared-link.dto.ts:21`, `shared-link.service.ts:97`.
-- **Update / delete** — owner-scoped edit of the same fields; delete. `shared-link.controller.ts:120,140`.
-- **Individual-link asset membership** — add/remove assets (only for `INDIVIDUAL` type), with per-asset access check and duplicate/not-found reporting. `shared-link.controller.ts:155,177`, `shared-link.service.ts:148,191`.
-- **Public access path** — link is consumed via a `key` query param (and/or `slug`) carried as headers `x-immich-share-key` / `x-immich-share-slug`; auth guard resolves it to a `sharedLink` auth context. Endpoints opt in with `sharedLink: true` (e.g. album get, map markers, asset thumbnail). `enum.ts:23,32`, `album.controller.ts:60`.
-- **Password flow** — for password-protected links: `POST /shared-links/login` checks the password, then issues a token stored in cookie `immich_shared_link_token` (comma-joined to support multiple links). `GET /shared-links/me` returns the current link, rejecting if password set and token absent. Token = `sha256(id-password)` base64. `shared-link.service.ts:26,46`, `controllers/shared-link.controller.ts:70` (login), `:92` (me).
-- **Metadata stripping** — when `showExif=false`, asset metadata is stripped from responses; OpenGraph preview tags are suppressed for password-protected links. `shared-link.service.ts:60,209`.
-- **List / search** — list all of a user's links, filter by `albumId` or `id`. `shared-link.controller.ts:62`.
-
-### Partner sharing — `controllers/partner.controller.ts`, `dtos/partner.dto.ts`
-- **Model** — directional: a user (`sharedById`) shares their whole library with another user (`sharedWithId`); PK is the pair. `schema/tables/partner.table.ts:25`.
-- **Create / remove** — start/stop sharing with a partner (by `sharedWithId`). A deprecated `POST /partners/:id` variant exists. `partner.controller.ts:36,67`.
-- **Update** — `inTimeline` toggle: whether the partner's assets appear in the user's main timeline. `partner.controller.ts:55`, `dtos/partner.dto.ts:16`.
-- **List** — by `direction` (shared-by-me vs shared-with-me). `partner.controller.ts:23`, `dtos/partner.dto.ts:21`.
-- **Access** — partner-shared assets are readable by the partner via an access-repo join (`partner.sharedWithId = userId`). `repositories/access.repository.ts:201`.
-
-## 3. Data model (abstract)
-
-| Table | Key columns | Notes |
-|---|---|---|
-| `album` | id, albumName (default), description, albumThumbnailAssetId (FK asset, SET NULL), order (enum), isActivityEnabled (bool), createdAt, updatedAt, deletedAt (soft delete) | cover + ordering live here. `album.table.ts` |
-| `album_asset` | (albumId, assetId) composite PK, createdAt | membership join; CASCADE on both FKs. `album-asset.table.ts` |
-| `album_user` | (albumId, userId) composite PK, role enum (owner/editor/viewer) | unique partial index: one `owner` per album. `album-user.table.ts` |
-| `shared_link` | id, userId (FK), key (bytea, unique), type (ALBUM/INDIVIDUAL), albumId (nullable FK), description, password (nullable), slug (nullable unique), expiresAt (nullable), allowUpload, allowDownload, showExif | one row per link. `shared-link.table.ts` |
-| `shared_link_asset` | (assetId, sharedLinkId) composite PK | for INDIVIDUAL links. `shared-link-asset.table.ts` |
-| `partner` | (sharedById, sharedWithId) composite PK, inTimeline (bool), createdAt | directional library share. `partner.table.ts` |
-| `activity` | id, albumId (FK), userId (FK), assetId (nullable FK), comment (nullable), isLiked (bool) | like XOR comment (check constraint); unique like per (asset,user,album). `activity.table.ts` |
-
-(Reference also keeps `*_audit` tables for sync; not needed for parity.)
-
-## 4. API surface
-
-Albums (`/albums`):
-- `GET /albums` (list, filters) · `POST /albums` (create) · `GET /albums/statistics` · `GET /albums/:id` (sharedLink-accessible) · `PATCH /albums/:id` (metadata/cover/order) · `DELETE /albums/:id`
-- `GET /albums/:id/map-markers` · `PUT /albums/:id/assets` (add) · `PUT /albums/assets` (multi-album add) · `DELETE /albums/:id/assets` (remove)
-- `PUT /albums/:id/users` (share) · `PUT /albums/:id/user/:userId` (role) · `DELETE /albums/:id/user/:userId` (remove/leave)
-
-Shared links (`/shared-links`):
-- `GET /shared-links` (list) · `POST /shared-links` (create) · `GET /shared-links/:id` · `PATCH /shared-links/:id` · `DELETE /shared-links/:id`
-- `POST /shared-links/login` (password) · `GET /shared-links/me` (current link) · `PUT /shared-links/:id/assets` · `DELETE /shared-links/:id/assets`
-
-Partners (`/partners`):
-- `GET /partners?direction=` · `POST /partners` · `POST /partners/:id` (deprecated) · `PUT /partners/:id` (inTimeline) · `DELETE /partners/:id`
-
-Activities (`/activities`):
-- `GET /activities` (by album/asset) · `POST /activities` (like/comment) · `GET /activities/statistics` · `DELETE /activities/:id`
-
-## 5. Find today + GAP
-
-Find routers present: auth, cluster(s), config, duplicates, feedback, gallery, people, search, status, upload, vault. Models: cluster, face, feedback, invite, join_request, media, person, session, user, vault. **No album, album_asset, album_user, shared_link, partner, or activity** — entire lane is greenfield.
-
-- `invite.py` (`InviteToken`) and `join_request.py` (`JoinRequest`) are **instance-onboarding**, not content sharing: an admin mints a single-use, SHA-256-hashed invite token; a prospective user submits a join request (username + bcrypt-style password hash + optional invite FK + pending/approved status) for admin approval. They share *nothing* with the album/shared-link/partner model and should not be conflated. (`backend/src/find_api/models/invite.py`, `join_request.py`.)
-- **GAP — everything**: album CRUD + membership + roles + cover + ordering; shared links (album & individual, password/expiry/slug/upload/download/metadata flags + public key/slug access); partner sharing; optional activity feed. Permission model and per-resource access checks must be built; Find has only user/session auth today.
-
-## 6. Security notes
-
-- **Shared-link password is stored and compared in plaintext** in the reference (`password !== dto.password`, `shared-link.service.ts:38`). **Do not copy this.** Find should hash share-link passwords (the codebase already hashes invite tokens with SHA-256 and join-request passwords — reuse that discipline). At minimum constant-time compare; preferably a slow hash.
-- **Capability key** — the random 50-byte `key` is the bearer capability for public access; it must be unguessable (CSPRNG), unique-indexed, and never logged. Slugs are public/guessable, so slug access must still resolve to the same scoped permissions, not bypass them.
-- **Access scoping** — every shared-link/album read must be scoped to exactly the linked album/assets; the reference enforces this via an access repository join layer (`access.repository.ts`). Public (shared-link) auth must never widen to the owner's whole library. Album endpoints that accept `sharedLink: true` must strip metadata when `showExif=false` and block download when `allowDownload=false`.
-- **Permission enforcement** — reference uses fine-grained permissions (`album.*`, `albumAsset.*`, `albumUser.*`, `sharedLink.*`, `partner.*`, `AlbumShare`, `AssetShare`). Find needs an equivalent owner/editor/viewer check on every album mutation and an ownership check on every shared-link mutation.
-- **Expiry** — `expiresAt` must be enforced server-side on every access, not just hidden in UI.
-- **Partner direction** — partner access is one-directional; ensure `sharedWithId` can read but not mutate the sharer's assets.
-
-## 7. Effort estimate
-
-| Feature | Size | Rationale |
-|---|---|---|
-| Album CRUD + cover + ordering | **M** | 2 tables, soft delete, metadata update |
-| Album asset membership (incl. bulk/multi-album) | **M** | join table + per-asset result reporting |
-| Album user roles / sharing | **M** | role enum, owner-uniqueness, access checks |
-| Shared links (album + individual, all flags) | **L** | key gen, slug uniqueness, password hashing, public access path, metadata stripping, expiry, asset membership |
-| Partner sharing | **S–M** | one table, directional access join, timeline toggle |
-| Activity feed (likes/comments) | **M** | constraints, statistics, optional for v1 |
-| Permission/access-control layer (shared dep) | **L** | cross-cutting; gates all of the above |
diff --git a/docs/overhaul/inventory/lane-c-archive-favorites-trash.md b/docs/overhaul/inventory/lane-c-archive-favorites-trash.md
deleted file mode 100644
index f0103f2f..00000000
--- a/docs/overhaul/inventory/lane-c-archive-favorites-trash.md
+++ /dev/null
@@ -1,106 +0,0 @@
-# Lane C — Archive, Favorites, Trash (and Restore)
-
-Read-only discovery. Reference = `reference-app/` (NestJS server). Target = Find (`backend/src/find_api/`).
-Reference behavior/state-model/scoping extracted; no source copied.
-
----
-
-## 1. State model
-
-The reference asset carries **three orthogonal flags**, not one. Archive and Trash are NOT booleans — they are values on two enums; only Favorite is a boolean.
-
-| Concept | Column | Type | Default | Reference |
-|---|---|---|---|---|
-| Favorite | `isFavorite` | boolean | false | `reference-app/server/src/schema/tables/asset.table.ts:83-84` |
-| Archive / Timeline visibility | `visibility` | enum `asset_visibility_enum` | `timeline` | `asset.table.ts:137-138` |
-| Soft-delete timestamp | `deletedAt` | timestamptz, nullable | null | `asset.table.ts:119-120` |
-| Lifecycle status | `status` | enum `assets_status_enum` | `active` | `asset.table.ts:131-132` |
-
-Enum values:
-- `AssetVisibility` = `archive` | `timeline` | `hidden` | `locked` — `reference-app/server/src/enum.ts:1137-1145`. **Archive is a visibility value**, not a separate flag. `timeline` = shows in main grid; `archive` = archived (hidden from timeline, still owned/searchable in archive view).
-- `AssetStatus` = `active` | `trashed` | `deleted` — `reference-app/server/src/enum.ts:390-393`. `trashed` = in trash (recoverable); `deleted` = marked for permanent purge.
-
-Key insight: **trash uses two coordinated fields** — `status` (active/trashed/deleted) AND `deletedAt` (timestamp). `deletedAt IS NOT NULL` means "in trash"; `status` distinguishes recoverable trash (`trashed`) from queued-for-purge (`deleted`). The `deletedAt` timestamp drives auto-purge timing.
-
-A partial index optimizes the hot path: `visibility = 'timeline' AND "deletedAt" IS NULL` — `asset.table.ts:58-62`.
-
----
-
-## 2. Transitions
-
-All bulk mutations flow through `updateAll` / `deleteAll`.
-
-- **Favorite / Unfavorite** — set `isFavorite` via bulk update. `AssetService.updateAll` extracts `isFavorite` from DTO and persists it (`reference-app/server/src/services/asset.service.ts:130-174`, esp. `:133, :146, :172-173`).
-- **Archive / Unarchive** — set `visibility` to `archive` (archive) or `timeline` (unarchive) via the same `updateAll` path (`asset.service.ts:134, :146, :172-173`). Setting `visibility=locked` additionally strips the asset from all albums (`asset.service.ts:176-178`).
-- **Trash (soft delete)** — `deleteAll` with `force=false`: sets `deletedAt = now()` and `status = trashed`, then emits `AssetTrashAll` (`asset.service.ts:370-382`, esp. `:374-377`).
-- **Permanent delete (skip trash)** — `deleteAll` with `force=true`: sets `deletedAt = now()` and `status = deleted`, emits `AssetDeleteAll` (`asset.service.ts:374-378`).
-- **Restore (single/bulk)** — set `status = active`, `deletedAt = null` for given ids where `status = trashed` (`reference-app/server/src/repositories/trash.repository.ts:38-52`; service `reference-app/server/src/services/trash.service.ts:12-25`).
-- **Restore all** — same, scoped to one owner where `status = trashed` (`trash.repository.ts:14-24`; `trash.service.ts:27-33`).
-- **Empty trash** — flips all owner's `trashed` rows to `status = deleted` (`trash.repository.ts:26-36`), then queues the `AssetEmptyTrash` background job which streams every `status = deleted` id and queues real `AssetDelete` (disk + DB) jobs (`trash.service.ts:35-84`, esp. getDeletedIds `trash.repository.ts:10-12`).
-- **Auto-purge after N days** — `AssetDeleteCheck` background job: computes `trashedBefore = now() − config.trash.days` (disabled ⇒ 0 days), streams assets with `deletedAt <= trashedBefore`, queues `AssetDelete` (`asset.service.ts:273-305`, esp. `:276-279, :294`; query `reference-app/server/src/repositories/asset-job.repository.ts:410-414` filters `asset.deletedAt <= trashedBefore`). `AssetDelete` does the irreversible file+row removal (`asset.service.ts:307+`).
-
----
-
-## 3. Query scoping — THE KEY PART
-
-Two independent predicates gate almost every "normal" asset query:
-1. **`deletedAt IS NULL`** — excludes anything in trash (trashed or queued-for-delete).
-2. **`visibility IN ('timeline','archive')`** — excludes `hidden` and `locked`; archived assets are NOT excluded by default visibility.
-
-The default-visibility helper: `withDefaultVisibility` = `where visibility IN ('archive','timeline')` (`reference-app/server/src/utils/database.ts:82-84`).
-
-**Main timeline** (the photo grid): `visibility = 'timeline' AND deletedAt IS NULL` — archived assets ARE excluded here because timeline requires `= 'timeline'` exactly (`asset.repository.ts:481, :490`; bucket builder `:967-972, :985-987`; search repo timeline `reference-app/server/src/repositories/search.repository.ts:388-390, :404-406, :499-500`).
-
-**Archive view**: `visibility = 'archive' AND deletedAt IS NULL` (timeline query parameterized by `visibility`, `asset.repository.ts:767, :842`).
-
-**Favorites view**: `isFavorite = true` plus the standard `deletedAt IS NULL` and a visibility filter (`asset.repository.ts:782, :868`).
-
-**Trash view**: inverts the trash predicate — `deletedAt IS NOT NULL AND status != 'deleted'` (recoverable trash only, excludes purge-queued rows) (`asset.repository.ts:712-713, :750-751, :840, :899`).
-
-**Search** scoping (`search.repository.ts`): options carry `visibility`, `isFavorite`, `withDeleted` (`:27, :32-35`). Search applies `visibility = 'timeline'` + `deletedAt IS NULL` by default, with `isFavorite` available as a filter (`:388-390, :191-275, :499-500`).
-
-**Statistics** mirror the same gates with toggles: `withDefaultVisibility` when no explicit visibility, optional `isFavorite`, and trash inversion (`asset.repository.ts:701-714`).
-
-Summary scoping rule: a row is "in the main timeline" iff **`visibility = 'timeline'` AND `deletedAt IS NULL`**. Archive flips visibility to `'archive'`; trash sets `deletedAt`; both naturally drop the row from the timeline grid.
-
----
-
-## 4. API surface
-
-Trash controller — `reference-app/server/src/controllers/trash.controller.ts`:
-- `POST /trash/empty` — permanently delete all trashed items (queues purge) (`:16-25`).
-- `POST /trash/restore` — restore all trashed items for the user (`:28-37`).
-- `POST /trash/restore/assets` — restore specific asset ids from trash (body = BulkIdsDto) (`:40-49`).
-
-Asset controller — `reference-app/server/src/controllers/asset.controller.ts`:
-- `PUT /assets` — bulk update; carries `isFavorite` and `visibility` (archive/unarchive, favorite/unfavorite) (`:56-70`).
-- `PATCH /assets` — same handler, v3 (`:72-78`).
-- `DELETE /assets` — bulk soft-delete (trash) or `force` permanent delete (`:80-90`).
-- `PUT /assets/:id` — single-asset update (favorite/visibility) (`:141`).
-
-(Background jobs, not HTTP: `AssetEmptyTrash`, `AssetDeleteCheck`, `AssetDelete`.)
-
----
-
-## 5. Find today + GAP
-
-**`backend/src/find_api/models/media.py`** has:
-- `liked` boolean (default false) — `media.py:39-41`. This is Find's favorite equivalent (already exists).
-- `is_hidden` boolean + `hidden_at` + `vault_state` (`visible`/...) + `encrypted_at` — `media.py:43-54`. This is the vault/hidden system (Lane B's concern), NOT archive/trash.
-- `status` String = `pending|processing|indexed|failed` — `media.py:57-58`. **This is processing status, a totally different axis** from reference's `active/trashed/deleted` lifecycle. Cannot be reused for trash.
-- **No `is_archived`, no `deleted_at`/`trashed_at`, no archive/trash lifecycle.** Confirmed: Find has NO trash, NO archive today. Favorites exist as `liked`.
-
-**`backend/src/find_api/routers/gallery.py` scoping today**: gallery list filters only `Media.is_hidden.is_(False)` then applies `scope_media_query` (ownership/IDOR) + optional `status`/`liked`/metadata/date filters (`gallery.py:194, :355-358; core/dependencies.py:75-87`). `liked` is an optional filter, not a separate view. Search scopes by `status='indexed' AND vector IS NOT NULL AND is_hidden = false` (`routers/search.py:128, :262, :311`).
-
-**GAP:**
-- Add `is_archived` (boolean, default false, indexed) and `deleted_at` (timestamptz nullable, indexed) to `media.py`. Optionally a `trash` lifecycle marker, but `deleted_at IS NULL/NOT NULL` plus an "empty-trash purge" pass is sufficient for a single-user app (status enum can be deferred — YAGNI). Favorites already covered by `liked`.
-- Gallery base query must add `Media.deleted_at.is_(None)` (exclude trash) AND `Media.is_archived.is_(False)` (exclude archive) to the existing `is_hidden == False` gate.
-- New views: archive = `is_archived == True, deleted_at IS NULL`; trash = `deleted_at IS NOT NULL`; favorites = existing `liked == True` (+ default scoping).
-- Search query must also gain `deleted_at IS NULL` and `is_archived = false` (currently filters only `is_hidden`).
-- New endpoints: trash/restore/empty + archive toggle + (existing) like toggle. Add an auto-purge job (delete rows where `deleted_at <= now − N days`).
-
----
-
-## 6. Effort estimate
-
-**M (Medium).** Two new columns + Alembic migration + small backfill. Scoping changes are mechanical but touch every list/search/count query (gallery, search, stats, duplicates, people) — the risk is missing a query and leaking trashed/archived rows. New trash/archive/restore endpoints + one auto-purge background task. Favorites is already done (`liked`). No new infra. Bulk of effort is auditing every existing query for the two new predicates and adding the purge job.
diff --git a/docs/overhaul/inventory/lane-d-viewer-slideshow.md b/docs/overhaul/inventory/lane-d-viewer-slideshow.md
deleted file mode 100644
index 78746129..00000000
--- a/docs/overhaul/inventory/lane-d-viewer-slideshow.md
+++ /dev/null
@@ -1,183 +0,0 @@
-# Lane D — Asset Viewer & Slideshow Inventory
-
-Read-only behavioral extraction from the reference app (Immich-style Svelte 5 web) compared against Find's current `image-preview-modal.tsx`. Reference paths are relative to `reference-app/web/src/lib/`. No source copied — behaviors only.
-
-Key reference files:
-- `components/asset-viewer/AssetViewer.svelte` — shell: layout, navigation, slideshow orchestration, stack, preload wiring.
-- `components/asset-viewer/PhotoViewer.svelte` — the photo surface: zoom action, swipe, dblclick, keyboard (z/s/copy), face/OCR overlays, cast hook.
-- `components/AdaptiveImage.svelte` — progressive thumbnail→preview→original rendering + GPU raster sizing.
-- `utils/adaptive-image-loader.svelte.ts` — `AdaptiveImageLoader` quality-chain state machine.
-- `components/asset-viewer/PreloadManager.svelte.ts` — neighbor preloading.
-- `actions/zoom-image.ts` — wheel/pinch zoom via `@zoom-image/core`.
-- `managers/asset-viewer-manager.svelte.ts` — zoom state, animated zoom, panel state.
-- `components/asset-viewer/SlideshowBar.svelte` — slideshow controls, progress bar, auto-hide.
-- `stores/slideshow.store.ts` — persisted slideshow settings + state machine.
-- `utils/slideshow-history.ts` — shuffle history (back/forward).
-- `components/asset-viewer/SlideshowMetadataOverlay.svelte` — slideshow caption/date/location overlay.
-- `managers/cast-manager.svelte.ts` — Google Cast (note only).
-
----
-
-## 1. Viewer behaviors
-
-### Open / close
-- Viewer is a full-screen fixed `` grid (`AssetViewer.svelte:488-493`), `bg-black`, with `focusTrap` action and `contain: layout`.
-- On open: adds `asset-viewer-open` class to `document.body` (`AssetViewer.svelte:152-153, 373-377`); on destroy resets activity, panel state, removes the class, and tears down preloaders (`:177-182`).
-- Close: `closeViewer()` calls `onClose?.(asset.id)` (`:184-186`). Bound to `Escape` and to the back-arrow button in the nav bar (`AssetViewerNavBar.svelte:78` — `shortcuts: [{ key: 'Escape' }]`).
-
-### Next / previous navigation
-- `navigateAsset(order?)` is the single nav entry point (`AssetViewer.svelte:198-250`). Guards re-entrancy with an `InvocationTracker` (`:197, 209-213`) so rapid presses don't stack.
-- Calls `preloadManager.cancelBeforeNavigation(order)` first (`:207`) to drop the now-irrelevant neighbor preload.
-- Non-slideshow: forward = `navigateToAsset(cursor.nextAsset)`, back = `cursor.previousAsset` (`:229-231`).
-- Prev/next on-screen affordances are `PreviousAssetAction` / `NextAssetAction` components, only shown when `showNavigation`, not editing, and a neighbor exists (`:526-530, 604-608`).
-- Stack navigation: ArrowUp/ArrowDown move within an asset stack (`:252-266, 483-485`).
-
-### Zoom
-- Wheel/pinch zoom is the `zoomImageAction` (`actions/zoom-image.ts:11-16`) using `@zoom-image/core` `createZoomImageWheel`, `maxZoom: 10`, seeded from `assetViewerManager.zoomState`. Applied on the photo container (`PhotoViewer.svelte:220`).
-- Double-click / double-tap toggles zoom between 1x and 2x via `onZoom` → `assetViewerManager.animatedZoom(targetZoom)` (`PhotoViewer.svelte:103-106, 219`); `animatedZoom` is a 300ms `cubicOut` rAF tween (`asset-viewer-manager.svelte.ts:143-161`).
-- Keyboard `z` also toggles zoom (`PhotoViewer.svelte:206`).
-- Synthetic dblclick from touch double-tap is suppressed so it doesn't double-fire with the zoom lib (`zoom-image.ts:103-125`).
-- Zoom state resets on every asset change (`PhotoViewer.svelte:50-54`, `AdaptiveImage.svelte:138-142`).
-
-### Pan
-- Pan is handled internally by `@zoom-image/core` (position tracked as `currentPositionX/Y` in `zoomState`, `asset-viewer-manager.svelte.ts:24-30`). No separate pan code — pointer drag while zoomed pans.
-- `node.style.touchAction = 'none'` set so the browser doesn't intercept pan/pinch (`zoom-image.ts:128`).
-- Pointerdown cancels any running zoom animation so a drag feels immediate (`zoom-image.ts:26`).
-
-### Keyboard shortcuts (each key)
-| Key | Action | Source |
-|-----|--------|--------|
-| `Escape` | Close viewer (or exit slideshow when in slideshow) | `AssetViewerNavBar.svelte:78`; `SlideshowBar.svelte:144` |
-| `ArrowLeft` | Previous asset (slideshow bar binds it too) | `SlideshowBar.svelte:145`; viewer prev via affordance |
-| `ArrowRight` | Next asset | `SlideshowBar.svelte:146` |
-| `ArrowUp` | Previous in stack | `AssetViewer.svelte:483` |
-| `ArrowDown` | Next in stack | `AssetViewer.svelte:484` |
-| `z` | Toggle zoom (1x ↔ 2x) | `PhotoViewer.svelte:206` |
-| `s` | Start slideshow | `PhotoViewer.svelte:207` |
-| `Ctrl/Cmd + c` | Copy image to clipboard (skipped if a text range is selected) | `PhotoViewer.svelte:208-209, 117-124` |
-| `Space` | Pause/resume slideshow progress (photos only; videos keep native space) | `SlideshowBar.svelte:150-162` |
-- Shortcuts are registered via a `use:shortcuts` action bound to `svelte:document` (`PhotoViewer.svelte:204-211`, `AssetViewer.svelte:480-486`).
-
-### Swipe / touch
-- `useSwipe` from `svelte-gestures` wraps the photo container (`PhotoViewer.svelte:23, 221`).
-- `onSwipe` (`AssetViewer.svelte:458-474`): swipe left → next, swipe right → previous. Suppressed when `zoom > 1` (so panning a zoomed image doesn't navigate) and when an OCR overlay is active.
-- Slideshow bar has its own swipe: `pan-x` touch action, `onswipedown` re-shows the control bar (`SlideshowBar.svelte:135-140, 171`).
-
-### Thumbnail → full-res progressive load
-- `AdaptiveImage.svelte` stacks up to three `` elements (thumbnail, preview, original) and shows/hides them by load state (`:251-286`).
-- Order: thumbhash placeholder (instant, from `asset.thumbhash`) → thumbnail → preview → original. The thumbhash blur shows until any real layer succeeds (`:185-196`).
-- `afterThumbnail` decides the next fetch: if `zoom > 1` jump straight to `original`, else fetch `preview` (`AdaptiveImage.svelte:96-102`). Preview error falls back to original (`:116`).
-- Original is only triggered lazily — when the user zooms past 1x (`AdaptiveImage.svelte:202-206`), not on initial display. This is the core loading-discipline rule.
-
----
-
-## 2. Slideshow behaviors
-
-### Start / stop
-- Start: pressing `s` or the nav action sets `slideshowState = PlaySlideshow` (`PhotoViewer.svelte:114, 207`). A subscription in `AssetViewer.onMount` resets shuffle history, queues the current asset, and runs `handlePlaySlideshow()` (`AssetViewer.svelte:154-162`).
-- `handlePlaySlideshow` records `slideshowStartAssetId` and requests fullscreen on the viewer element; failure to enter fullscreen aborts to `StopSlideshow` (`:284-292`).
-- Stop: `StopSlideshow` state → `handleStopSlideshow()` exits fullscreen and resets state to `None` (`:294-305`). Exiting fullscreen via the browser also stops the slideshow (`SlideshowBar.svelte:115-133`).
-
-### Interval / progress / autoplay
-- A `ProgressBar` drives advancement; `onDone` → `handleDone()` advances next (or previous for ascending order) (`SlideshowBar.svelte:98-106, 237-246`).
-- Duration is `slideshowDelay` (default 5s), with `slideshowAutoplay` (default true) and `showProgressBar` (default true) (`slideshow.store.ts:44-47`, bound `SlideshowBar.svelte:238-244`).
-- `Space` toggles pause/play of the progress bar (`SlideshowBar.svelte:150-162`).
-- On each successful navigation while playing, `restartProgress` is fired to reset the bar (`AssetViewer.svelte:237-240, 275`).
-- Video slides: the progress bar is hidden and the native video element handles playback; `handleVideoStarted` stops progress (`AssetViewer.svelte:278-282`, `SlideshowBar.svelte:42, 190-199, 237`).
-- Controls auto-hide after 2.5s of no mouse movement and hide the cursor; any mousemove re-shows them (`SlideshowBar.svelte:51-69, 168`).
-
-### Transitions / look
-- `slideshowTransition` (default true) toggles fly transitions on the control bar (`slideshow.store.ts:46`; `fly` used `SlideshowBar.svelte:178`).
-- `SlideshowLook` (`slideshow.store.ts:16-31`): `Contain` (default), `Cover` (object-cover), `BlurredBackground` (object-contain over a blurred thumbhash backdrop). Look feeds `objectFit` and the blurred backdrop in `PhotoViewer.svelte:152-154, 227, 240-244`.
-
-### Shuffle / repeat / order
-- `SlideshowNavigation` (`slideshow.store.ts:10-14`): `Shuffle`, `AscendingOrder` (backward), `DescendingOrder` (forward, default).
-- Shuffle uses `SlideshowHistory` (`utils/slideshow-history.ts`) — a back/forward stack so previous re-walks visited assets; when it runs out it calls `onRandom?.()` to pull a new random asset and queues it (`AssetViewer.svelte:214-227`, `slideshow-history.ts:21-39`).
-- `slideshowRepeat` (default false): when navigation exhausts the list, jumps back to `slideshowStartAssetId` and restarts; otherwise stops (`AssetViewer.svelte:242-248`).
-
-### Slideshow settings & metadata overlay
-- All settings live in `SlideshowSettingsModal.svelte` (delay, progress bar, navigation, look, transition, autoplay, repeat, metadata overlay + mode), all persisted to localStorage via `svelte-persisted-store` (`slideshow.store.ts:37-53`, modal `:42-50, 85-88`).
-- Optional metadata overlay (`SlideshowMetadataOverlay.svelte`): two modes — `DescriptionOnly` or `Full` (description + date + city/state/country) (`:18-35`).
-
----
-
-## 3. Loading discipline
-
-Quality chain is thumbnail → preview → original, modeled by `AdaptiveImageLoader` (`utils/adaptive-image-loader.svelte.ts:34-126`).
-
-Rules:
-1. **Thumbhash first.** `asset.thumbhash` renders an instant blurred placeholder with zero network (`AdaptiveImage.svelte:242-249`).
-2. **Thumbnail is the entry fetch**, then `onAfterLoad`/`onAfterError` chains to the next quality (`adaptive-image-loader` quality configs; `AdaptiveImage.svelte:104-121`).
-3. **Preview is the default display quality** at zoom = 1 (`afterThumbnail` triggers `preview`, `AdaptiveImage.svelte:96-102`).
-4. **Original is deferred** — only fetched when the user zooms past 1x (`AdaptiveImage.svelte:202-206`, `PhotoViewer.svelte` zoom path), or when preview fails (`:116`). Avoids paying full-res bytes for casual browsing.
-5. **Error fallbacks cascade**: thumbnail error → still try preview; preview error → original; original error → BrokenAsset (`AdaptiveImage.svelte:185-196, 289-291`).
-
-Neighbor preloading (`PreloadManager.svelte.ts`):
-- On viewer mount, preloads both `previousAsset` and `nextAsset` to thumbnail+preview (not original) (`:89-96, 23-42`).
-- After each navigation, `updateAfterNavigation` keeps the preloader heading the same direction and discards the stale one; `cancelBeforeNavigation` aborts the opposite-direction preload before moving (`:54-87`, called `AssetViewer.svelte:207, 400-412`).
-- Preloaders are torn down on viewer destroy (`AssetViewer.svelte:181`).
-
-GPU/raster note (Chromium HDR seam workaround): `AdaptiveImage` sizes the image div near native resolution and counter-scales with `will-change: transform`, capping raster pixels by GPU `MAX_TEXTURE_SIZE` (`AdaptiveImage.svelte:1-49, 152-180`). Niche — low priority for Find port.
-
----
-
-## 4. Find today + GAP
-
-Find's `image-preview-modal.tsx` is a metadata-rich detail dialog, not a real viewer.
-
-What it does today:
-- Split layout: image stage on the left, a long metadata sidebar (file info, caption, objects, OCR, analysis stages, like/download/delete/reprocess) (`image-preview-modal.tsx:368-884`).
-- Single `` with `object-contain`, `unoptimized`, one resolution from `resolveMediaUrl` (`:387-410`). No thumbnail/preview/original tiering.
-- Keyboard: only `Escape` (close), `ArrowLeft`/`ArrowRight` (prev/next, gated on `hasPrevious`/`hasNext`) (`:345-366`).
-- Prev/next chevron buttons (`:412-437`). No swipe/touch.
-- Detail data via React Query with stale/refresh tuned to MinIO URL expiry, polling faster while pending/processing (`:236-248`).
-
-GAP vs reference:
-- **No zoom** (no `z`, no double-tap, no pinch/wheel). Biggest gap.
-- **No pan.**
-- **No progressive loading** — loads one resolution; no thumbhash/blur placeholder, no preview→original tiering, so large originals block the stage behind a spinner (`:388-391`).
-- **No neighbor preloading** — next/prev navigation re-fetches cold every time.
-- **No swipe/touch navigation.**
-- **No slideshow at all** — no play, interval, shuffle, repeat, transitions, fullscreen, or settings.
-- **No copy-to-clipboard of the image** (`Ctrl/Cmd+c`); Find only copies caption/OCR text.
-- **No fullscreen** mode for the image.
-- **No re-entrancy guard** on rapid arrow presses (reference uses `InvocationTracker`).
-- Find's media layer (`lib/media.ts`) only distinguishes a thumbnail endpoint (`/api/image/:id/thumbnail`) vs the full object URL — there is no "preview" (mid-res) tier, so a true thumbnail→preview→original chain needs a backend preview endpoint or an agreed two-tier (thumbnail→original) compromise.
-
----
-
-## 5. Port notes (React)
-
-- **Zoom/pan**: don't hand-roll. Use a maintained React lib:
- - `react-zoom-pan-pinch` (most popular; wheel+pinch+double-tap, `TransformWrapper`/`TransformComponent`, programmatic `zoomToElement`/reset) — closest drop-in for the reference's wheel+dblclick behavior.
- - Alternatives: `@use-gesture/react` + `@react-spring/web` for full control (matches the rAF-tweened `animatedZoom`), or wrap the same `@zoom-image/core` the reference uses (framework-agnostic) behind a small hook.
- - Recommendation: `react-zoom-pan-pinch` for speed; reset transform on asset change, gate swipe-nav on `scale === 1`.
-- **Keyboard**: a single `useEffect` window `keydown` listener already exists in Find (`:345-366`); extend it with `z` (zoom toggle), `s` (slideshow), and `Space` (slideshow pause). Keep `Escape` context-aware (exit slideshow before closing viewer). Consider `react-hotkeys-hook` if the map grows.
-- **Swipe**: `@use-gesture/react` `useDrag`/`useSwipe`, or `react-swipeable`. Mirror the "disabled when zoomed" rule.
-- **Progressive image**: render layered ` ({
id: a.id,
- thumbnailUrl: a.thumbnailUrl,
- originalUrl: `/api/image/${a.id}/original`,
+ thumbnailUrl:
+ resolveMediaUrl(a.thumbnailUrl, null, a.id, true) ?? a.thumbnailUrl,
+ originalUrl:
+ resolveMediaUrl(`/api/image/${a.id}/original`) ??
+ `/api/image/${a.id}/original`,
alt: a.createdAt
? `Photo from ${new Date(a.createdAt).toLocaleDateString()}`
: `Photo ${a.id}`,
@@ -254,7 +258,10 @@ export default function TimelinePage() {
>
{/* biome-ignore lint/performance/noImgElement: authenticated API thumbnail */}
({
const viewerAssets = useMemo(
() =>
timelineItems.map((item) => {
- const thumbnailUrl = getThumbnailUrl(item) ?? "";
+ const id = getId(item);
+ const rawThumbnailUrl = getThumbnailUrl(item);
+ const thumbnailUrl = resolveApiRoute(rawThumbnailUrl) ?? "";
+ const rawOriginalUrl = getOriginalUrl(item);
return {
- id: getId(item),
+ id,
thumbnailUrl,
alt: getAlt(item),
// View-only shares deliberately fall back to their share-scoped
// thumbnail; a private route is never synthesized here.
- originalUrl: getOriginalUrl(item) ?? thumbnailUrl,
+ originalUrl: resolveApiRoute(rawOriginalUrl) ?? thumbnailUrl,
};
}),
[getAlt, getId, getOriginalUrl, getThumbnailUrl, timelineItems],
@@ -305,7 +313,8 @@ export function TimelineMediaView({
getKey={({ item }) => getId(item)}
renderItem={({ item }, index) => {
const timelineIndex = groupStartIndex + index;
- const thumbnailUrl = getThumbnailUrl(item);
+ const rawThumbnailUrl = getThumbnailUrl(item);
+ const thumbnailUrl = resolveApiRoute(rawThumbnailUrl);
return (
Date: Mon, 13 Jul 2026 04:07:38 +0530
Subject: [PATCH 08/21] fix: secure the full AI caption pipeline
---
.env.example | 2 +-
README.md | 8 +-
backend/pyproject.toml | 4 +-
backend/src/find_api/core/config.py | 2 +-
backend/src/find_api/ml/captioner.py | 83 +++++-------------
backend/src/find_api/workers/jobs.py | 2 +-
backend/tests/test_status.py | 4 +-
backend/uv.lock | 115 +++++++++++++++----------
docs/guides/hardware-acceleration.md | 2 +-
docs/guides/real-ml-troubleshooting.md | 2 +-
10 files changed, 106 insertions(+), 118 deletions(-)
diff --git a/.env.example b/.env.example
index 28c240e1..b336be9a 100644
--- a/.env.example
+++ b/.env.example
@@ -106,7 +106,7 @@ ML_OFFLINE_ONLY=false
RQ_WORKER_CLASS=rq.worker.worker_classes.SimpleWorker
CLIP_MODEL=ViT-B-16-SigLIP
CLIP_PRETRAINED=webli
-BLIP_MODEL=microsoft/Florence-2-base
+BLIP_MODEL=Salesforce/blip-image-captioning-base
YOLO_MODEL=yolo26n.pt
USE_GPU=true
YOLO_HALF=true
diff --git a/README.md b/README.md
index 3a91196f..9003c237 100644
--- a/README.md
+++ b/README.md
@@ -39,7 +39,7 @@ See the documentation index in [`docs/index.md`](./docs/index.md), the mobile di
- **Frontend:** Next.js 16, React 19, React Query, Tailwind CSS, Biome
- **Backend:** FastAPI, SQLAlchemy, PostgreSQL + pgvector, Redis, RQ, MinIO
-- **ML pipeline:** YOLO26 nano, Florence-2 base, PaddleOCR, SigLIP (`open-clip`), InsightFace, HDBSCAN
+- **ML pipeline:** YOLO26 nano, BLIP image captioning, PaddleOCR, SigLIP (`open-clip`), InsightFace, HDBSCAN
## Runtime profiles
@@ -142,7 +142,7 @@ For UI, API, upload, gallery, search, clustering, docs, and workflow changes, us
docker compose -f compose.mock.yml up --build
```
-This runs the same app flow with `ML_MODE=mock`, a Python slim backend image, and no GPU/model cache mount. It avoids downloading Florence-2, SigLIP, PaddleOCR, YOLO, CUDA PyTorch, and related model weights, so first-time setup is much smaller and faster.
+This runs the same app flow with `ML_MODE=mock`, a Python slim backend image, and no GPU/model cache mount. It avoids downloading BLIP, SigLIP, PaddleOCR, YOLO, CUDA PyTorch, and related model weights, so first-time setup is much smaller and faster.
Light mode is deterministic but not AI-accurate:
@@ -187,7 +187,7 @@ Because mock vectors have no semantic content, search results are meaningless
docker compose up --build
```
-The worker loads Florence-2 (captioning), YOLOv10 (object detection), PaddleOCR (text extraction), and SigLIP via `open-clip` (semantic embeddings). All metadata and vectors reflect real model output.
+The worker loads BLIP (captioning), YOLOv10 (object detection), PaddleOCR (text extraction), and SigLIP via `open-clip` (semantic embeddings). All metadata and vectors reflect real model output.
**Full ML mode is required when you are working on or reporting:**
@@ -213,7 +213,7 @@ The worker loads Florence-2 (captioning), YOLOv10 (object detection), PaddleOCR
| OCR missed text | ❌ No | ✅ Required |
| ML pipeline performance | ❌ No | ✅ Required |
-First run of the full stack downloads Florence-2, SigLIP, PaddleOCR, and YOLO weights (several GB). Models are cached in the `model_cache` Docker volume and reused on subsequent runs.
+First run of the full stack downloads BLIP, SigLIP, PaddleOCR, and YOLO weights (several GB). Models are cached in the `model_cache` Docker volume and reused on subsequent runs.
## Controlling AI from the dashboard
diff --git a/backend/pyproject.toml b/backend/pyproject.toml
index 3b8f9e83..afe982ce 100644
--- a/backend/pyproject.toml
+++ b/backend/pyproject.toml
@@ -36,7 +36,7 @@ mock = [
cpu = [
"torch==2.8.0",
"torchvision==0.23.0",
- "transformers==4.49.0",
+ "transformers==5.3.0",
"open-clip-torch>=2.24.0",
"opencv-python-headless==4.9.0.80",
"ultralytics>=8.2.0",
@@ -52,7 +52,7 @@ cpu = [
nvidia = [
"torch==2.8.0",
"torchvision==0.23.0",
- "transformers==4.49.0",
+ "transformers==5.3.0",
"open-clip-torch>=2.24.0",
"opencv-python-headless==4.9.0.80",
"ultralytics>=8.2.0",
diff --git a/backend/src/find_api/core/config.py b/backend/src/find_api/core/config.py
index 9d17d355..793734e0 100644
--- a/backend/src/find_api/core/config.py
+++ b/backend/src/find_api/core/config.py
@@ -69,7 +69,7 @@ class Settings(BaseSettings):
ML_OFFLINE_ONLY: bool = False
CLIP_MODEL: str = "ViT-B-16-SigLIP"
CLIP_PRETRAINED: str = "webli"
- BLIP_MODEL: str = "microsoft/Florence-2-base"
+ BLIP_MODEL: str = "Salesforce/blip-image-captioning-base"
YOLO_MODEL: str = "yolo26n.pt"
USE_GPU: bool = False
YOLO_HALF: bool = True
diff --git a/backend/src/find_api/ml/captioner.py b/backend/src/find_api/ml/captioner.py
index 251425e4..3c5538a4 100644
--- a/backend/src/find_api/ml/captioner.py
+++ b/backend/src/find_api/ml/captioner.py
@@ -1,9 +1,7 @@
-"""
-Image captioning using Florence-2
-"""
+"""Local image captioning using the native BLIP model implementation."""
import torch
-from transformers import AutoModelForCausalLM, AutoProcessor
+from transformers import BlipForConditionalGeneration, BlipProcessor
from PIL import Image
import numpy as np
from typing import Union
@@ -18,7 +16,7 @@
class ImageCaptioner:
- """Generate natural language captions for images using Florence-2"""
+ """Generate natural-language captions with a local BLIP checkpoint."""
def __init__(self):
self.manager = get_model_manager()
@@ -27,19 +25,21 @@ def __init__(self):
def _load_model(self):
"""Loader function for ModelManager"""
model_id = settings.BLIP_MODEL
- logger.info("Loading Florence-2 model: %s", model_id)
+ logger.info("Loading BLIP caption model: %s", model_id)
device = current_torch_device()
torch_dtype = torch.float16 if device == "cuda" else torch.float32
- model = AutoModelForCausalLM.from_pretrained(
+ model = BlipForConditionalGeneration.from_pretrained(
model_id,
- trust_remote_code=True,
- torch_dtype=torch_dtype,
- attn_implementation="eager",
+ trust_remote_code=False,
+ dtype=torch_dtype,
).to(device)
-
- processor = AutoProcessor.from_pretrained(model_id, trust_remote_code=True)
+ processor = BlipProcessor.from_pretrained(
+ model_id,
+ trust_remote_code=False,
+ use_fast=False,
+ )
return {
"model": model,
@@ -66,17 +66,14 @@ def generate_caption(
config_key = f"model={settings.BLIP_MODEL}|accel={current_accel_mode()}"
with self.manager.use_model(
- "florence-2", self._load_model, config_key=config_key
+ "captioner", self._load_model, config_key=config_key
) as bundle:
model = bundle["model"]
processor = bundle["processor"]
device = bundle["device"]
dtype = bundle["dtype"]
- # Florence-2 uses task prompts
- task_prompt = ""
-
- inputs = processor(text=task_prompt, images=image, return_tensors="pt")
+ inputs = processor(images=image, return_tensors="pt")
inputs = {
k: v.to(device, dtype)
if v.dtype == torch.float32 or v.dtype == torch.float16
@@ -87,7 +84,6 @@ def generate_caption(
# Generate
with torch.inference_mode():
generated_ids = model.generate(
- input_ids=inputs["input_ids"],
pixel_values=inputs["pixel_values"],
max_new_tokens=max_length,
num_beams=num_beams,
@@ -95,18 +91,9 @@ def generate_caption(
use_cache=True,
)
- generated_text = processor.batch_decode(
- generated_ids, skip_special_tokens=False
- )[0]
-
- # Post-process
- parsed_answer = processor.post_process_generation(
- generated_text,
- task=task_prompt,
- image_size=(image.width, image.height),
- )
-
- caption = parsed_answer.get(task_prompt, "")
+ caption = processor.decode(
+ generated_ids[0], skip_special_tokens=True
+ ).strip()
logger.info(f"Generated caption: {caption[:50]}...")
return caption
@@ -130,26 +117,14 @@ def generate_conditional_caption(
config_key = f"model={settings.BLIP_MODEL}|accel={current_accel_mode()}"
with self.manager.use_model(
- "florence-2", self._load_model, config_key=config_key
+ "captioner", self._load_model, config_key=config_key
) as bundle:
model = bundle["model"]
processor = bundle["processor"]
device = bundle["device"]
dtype = bundle["dtype"]
- # For VQA or specific prompts
- # For VQA or specific prompts
- # task_prompt = "" # Fallback or use prompt as VQA?
- # Florence-2 supports prompt
- # If prompt is a question, use
- # But for general conditional captioning, maybe just append?
- # Let's assume prompt is a question or task for now
-
- full_prompt = (
- f"{prompt}" if "?" in prompt else f"{prompt}"
- )
-
- inputs = processor(text=full_prompt, images=image, return_tensors="pt")
+ inputs = processor(text=prompt, images=image, return_tensors="pt")
inputs = {
k: v.to(device, dtype)
if v.dtype == torch.float32 or v.dtype == torch.float16
@@ -166,23 +141,9 @@ def generate_conditional_caption(
use_cache=True,
)
- generated_text = processor.batch_decode(
- generated_ids, skip_special_tokens=False
- )[0]
-
- # We might need manual parsing if post_process doesn't handle custom prompts well
- # But let's try standard
- caption = processor.post_process_generation(
- generated_text,
- task="",
- image_size=(image.width, image.height),
- )
-
- # If it returns dict
- if isinstance(caption, dict):
- caption = list(caption.values())[0]
-
- return str(caption)
+ return processor.decode(
+ generated_ids[0], skip_special_tokens=True
+ ).strip()
except Exception as e:
logger.error(f"Failed to generate conditional caption: {e}")
diff --git a/backend/src/find_api/workers/jobs.py b/backend/src/find_api/workers/jobs.py
index 6556f858..db3c4f71 100644
--- a/backend/src/find_api/workers/jobs.py
+++ b/backend/src/find_api/workers/jobs.py
@@ -44,7 +44,7 @@
logger.error(f"Failed to start model cleanup thread in worker: {e}")
FACE_CLUSTER_NAME_MATCH_THRESHOLD = 0.72
-ANALYSIS_MODEL_NAMES = ("yolo", "florence-2", "paddleocr", "siglip", "insightface")
+ANALYSIS_MODEL_NAMES = ("yolo", "captioner", "paddleocr", "siglip", "insightface")
def _begin_worker_runtime(db):
diff --git a/backend/tests/test_status.py b/backend/tests/test_status.py
index a13dba05..5e3ed693 100644
--- a/backend/tests/test_status.py
+++ b/backend/tests/test_status.py
@@ -138,7 +138,7 @@ def test_loaded_models_endpoint_includes_worker_snapshot(client):
"process": "worker",
"loaded_models": ["siglip"],
"in_flight": {},
- "failed_models": {"florence-2": {"error": "load failed", "failed_at": 0}},
+ "failed_models": {"captioner": {"error": "load failed", "failed_at": 0}},
"max_loaded_models": 5,
"updated_at": 0,
}
@@ -169,7 +169,7 @@ def test_loaded_models_endpoint_includes_worker_snapshot(client):
body = response.json()
assert "siglip" in body["loaded_models"]
assert (
- body["processes"]["worker"]["failed_models"]["florence-2"]["error"]
+ body["processes"]["worker"]["failed_models"]["captioner"]["error"]
== "load failed"
)
assert body["worker_health"]["state"] == "stale"
diff --git a/backend/uv.lock b/backend/uv.lock
index 51e212b5..e1441eb9 100644
--- a/backend/uv.lock
+++ b/backend/uv.lock
@@ -672,8 +672,8 @@ requires-dist = [
{ name = "torch", marker = "extra == 'nvidia'", specifier = "==2.8.0", index = "https://download.pytorch.org/whl/cu128", conflict = { package = "find-backend", extra = "nvidia" } },
{ name = "torchvision", marker = "extra == 'cpu'", specifier = "==0.23.0", index = "https://download.pytorch.org/whl/cpu", conflict = { package = "find-backend", extra = "cpu" } },
{ name = "torchvision", marker = "extra == 'nvidia'", specifier = "==0.23.0", index = "https://download.pytorch.org/whl/cu128", conflict = { package = "find-backend", extra = "nvidia" } },
- { name = "transformers", marker = "extra == 'cpu'", specifier = "==4.49.0" },
- { name = "transformers", marker = "extra == 'nvidia'", specifier = "==4.49.0" },
+ { name = "transformers", marker = "extra == 'cpu'", specifier = "==5.3.0" },
+ { name = "transformers", marker = "extra == 'nvidia'", specifier = "==5.3.0" },
{ name = "ultralytics", marker = "extra == 'cpu'", specifier = ">=8.2.0" },
{ name = "ultralytics", marker = "extra == 'nvidia'", specifier = ">=8.2.0" },
{ name = "uvicorn", extras = ["standard"], specifier = ">=0.43.0,<0.44" },
@@ -833,21 +833,22 @@ wheels = [
[[package]]
name = "huggingface-hub"
-version = "0.36.2"
+version = "1.23.0"
source = { registry = "https://pypi.org/simple" }
dependencies = [
+ { name = "click" },
{ name = "filelock" },
{ name = "fsspec" },
- { name = "hf-xet", marker = "platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'" },
+ { name = "hf-xet", marker = "platform_machine == 'AMD64' or platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'" },
+ { name = "httpx" },
{ name = "packaging" },
{ name = "pyyaml" },
- { name = "requests" },
{ name = "tqdm" },
{ name = "typing-extensions" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/7c/b7/8cb61d2eece5fb05a83271da168186721c450eb74e3c31f7ef3169fa475b/huggingface_hub-0.36.2.tar.gz", hash = "sha256:1934304d2fb224f8afa3b87007d58501acfda9215b334eed53072dd5e815ff7a", size = 649782, upload-time = "2026-02-06T09:24:13.098Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/1a/8f/999e4dda11c6187c78f090eac00895a47e11a0049308f07579bcb7aa3aa2/huggingface_hub-1.23.0.tar.gz", hash = "sha256:c04997fb8bbdace1e57b7703d30ed7678af51f70d00d241819ff411b92ae9a88", size = 919163, upload-time = "2026-07-09T14:49:32.315Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/a8/af/48ac8483240de756d2438c380746e7130d1c6f75802ef22f3c6d49982787/huggingface_hub-0.36.2-py3-none-any.whl", hash = "sha256:48f0c8eac16145dfce371e9d2d7772854a4f591bcb56c9cf548accf531d54270", size = 566395, upload-time = "2026-02-06T09:24:11.133Z" },
+ { url = "https://files.pythonhosted.org/packages/f1/ce/13b2ba57838b8db1e6bd033c1b21ce0b9f6153b87d4e4939f77074e41eb0/huggingface_hub-1.23.0-py3-none-any.whl", hash = "sha256:b1d604788f5adc7f0eb246e03e0ec19011ca06e38400218c347dccc3dffa64a2", size = 770336, upload-time = "2026-07-09T14:49:30.597Z" },
]
[[package]]
@@ -2231,24 +2232,26 @@ wheels = [
[[package]]
name = "safetensors"
-version = "0.7.0"
+version = "0.8.0"
source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/29/9c/6e74567782559a63bd040a236edca26fd71bc7ba88de2ef35d75df3bca5e/safetensors-0.7.0.tar.gz", hash = "sha256:07663963b67e8bd9f0b8ad15bb9163606cd27cc5a1b96235a50d8369803b96b0", size = 200878, upload-time = "2025-11-19T15:18:43.199Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/45/06/f955dbbb1859e3bd23c8ac6141af5106e7ad5fedec4a3a6e3d60f94b7001/safetensors-0.8.0.tar.gz", hash = "sha256:fabaf3e0f18a6618d9b36560682562157f77c2b71fcffc7b432be2baed9d753d", size = 325846, upload-time = "2026-06-09T07:52:25.563Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/fa/47/aef6c06649039accf914afef490268e1067ed82be62bcfa5b7e886ad15e8/safetensors-0.7.0-cp38-abi3-macosx_10_12_x86_64.whl", hash = "sha256:c82f4d474cf725255d9e6acf17252991c3c8aac038d6ef363a4bf8be2f6db517", size = 467781, upload-time = "2025-11-19T15:18:35.84Z" },
- { url = "https://files.pythonhosted.org/packages/e8/00/374c0c068e30cd31f1e1b46b4b5738168ec79e7689ca82ee93ddfea05109/safetensors-0.7.0-cp38-abi3-macosx_11_0_arm64.whl", hash = "sha256:94fd4858284736bb67a897a41608b5b0c2496c9bdb3bf2af1fa3409127f20d57", size = 447058, upload-time = "2025-11-19T15:18:34.416Z" },
- { url = "https://files.pythonhosted.org/packages/f1/06/578ffed52c2296f93d7fd2d844cabfa92be51a587c38c8afbb8ae449ca89/safetensors-0.7.0-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e07d91d0c92a31200f25351f4acb2bc6aff7f48094e13ebb1d0fb995b54b6542", size = 491748, upload-time = "2025-11-19T15:18:09.79Z" },
- { url = "https://files.pythonhosted.org/packages/ae/33/1debbbb70e4791dde185edb9413d1fe01619255abb64b300157d7f15dddd/safetensors-0.7.0-cp38-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:8469155f4cb518bafb4acf4865e8bb9d6804110d2d9bdcaa78564b9fd841e104", size = 503881, upload-time = "2025-11-19T15:18:16.145Z" },
- { url = "https://files.pythonhosted.org/packages/8e/1c/40c2ca924d60792c3be509833df711b553c60effbd91da6f5284a83f7122/safetensors-0.7.0-cp38-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:54bef08bf00a2bff599982f6b08e8770e09cc012d7bba00783fc7ea38f1fb37d", size = 623463, upload-time = "2025-11-19T15:18:21.11Z" },
- { url = "https://files.pythonhosted.org/packages/9b/3a/13784a9364bd43b0d61eef4bea2845039bc2030458b16594a1bd787ae26e/safetensors-0.7.0-cp38-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:42cb091236206bb2016d245c377ed383aa7f78691748f3bb6ee1bfa51ae2ce6a", size = 532855, upload-time = "2025-11-19T15:18:25.719Z" },
- { url = "https://files.pythonhosted.org/packages/a0/60/429e9b1cb3fc651937727befe258ea24122d9663e4d5709a48c9cbfceecb/safetensors-0.7.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dac7252938f0696ddea46f5e855dd3138444e82236e3be475f54929f0c510d48", size = 507152, upload-time = "2025-11-19T15:18:33.023Z" },
- { url = "https://files.pythonhosted.org/packages/3c/a8/4b45e4e059270d17af60359713ffd83f97900d45a6afa73aaa0d737d48b6/safetensors-0.7.0-cp38-abi3-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1d060c70284127fa805085d8f10fbd0962792aed71879d00864acda69dbab981", size = 541856, upload-time = "2025-11-19T15:18:31.075Z" },
- { url = "https://files.pythonhosted.org/packages/06/87/d26d8407c44175d8ae164a95b5a62707fcc445f3c0c56108e37d98070a3d/safetensors-0.7.0-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:cdab83a366799fa730f90a4ebb563e494f28e9e92c4819e556152ad55e43591b", size = 674060, upload-time = "2025-11-19T15:18:37.211Z" },
- { url = "https://files.pythonhosted.org/packages/11/f5/57644a2ff08dc6325816ba7217e5095f17269dada2554b658442c66aed51/safetensors-0.7.0-cp38-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:672132907fcad9f2aedcb705b2d7b3b93354a2aec1b2f706c4db852abe338f85", size = 771715, upload-time = "2025-11-19T15:18:38.689Z" },
- { url = "https://files.pythonhosted.org/packages/86/31/17883e13a814bd278ae6e266b13282a01049b0c81341da7fd0e3e71a80a3/safetensors-0.7.0-cp38-abi3-musllinux_1_2_i686.whl", hash = "sha256:5d72abdb8a4d56d4020713724ba81dac065fedb7f3667151c4a637f1d3fb26c0", size = 714377, upload-time = "2025-11-19T15:18:40.162Z" },
- { url = "https://files.pythonhosted.org/packages/4a/d8/0c8a7dc9b41dcac53c4cbf9df2b9c83e0e0097203de8b37a712b345c0be5/safetensors-0.7.0-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:b0f6d66c1c538d5a94a73aa9ddca8ccc4227e6c9ff555322ea40bdd142391dd4", size = 677368, upload-time = "2025-11-19T15:18:41.627Z" },
- { url = "https://files.pythonhosted.org/packages/05/e5/cb4b713c8a93469e3c5be7c3f8d77d307e65fe89673e731f5c2bfd0a9237/safetensors-0.7.0-cp38-abi3-win32.whl", hash = "sha256:c74af94bf3ac15ac4d0f2a7c7b4663a15f8c2ab15ed0fc7531ca61d0835eccba", size = 326423, upload-time = "2025-11-19T15:18:45.74Z" },
- { url = "https://files.pythonhosted.org/packages/5d/e6/ec8471c8072382cb91233ba7267fd931219753bb43814cbc71757bfd4dab/safetensors-0.7.0-cp38-abi3-win_amd64.whl", hash = "sha256:d1239932053f56f3456f32eb9625590cc7582e905021f94636202a864d470755", size = 341380, upload-time = "2025-11-19T15:18:44.427Z" },
+ { url = "https://files.pythonhosted.org/packages/39/a0/f718cda65b05407d228f97602cf60dca269c979867aa5beb25410de26cd3/safetensors-0.8.0-cp310-abi3-macosx_10_12_x86_64.whl", hash = "sha256:c554f85858e05226d3c2828e32395e677434685d6d94594a41643361c5e837f0", size = 473568, upload-time = "2026-06-09T07:52:18.829Z" },
+ { url = "https://files.pythonhosted.org/packages/f5/b1/fa7c600e7dceae12e9606c7578cbc9ff1e1ed55844883ee5c92205e86226/safetensors-0.8.0-cp310-abi3-macosx_11_0_arm64.whl", hash = "sha256:c80201d22cbf405b80647a60ada77bba06c8fba2da2743ba1e89cdcc39a81f25", size = 484562, upload-time = "2026-06-09T07:52:17.518Z" },
+ { url = "https://files.pythonhosted.org/packages/09/7d/65a7de0af421317bb36a067241e4235fff194eed60b961ed6d3f59a3fc60/safetensors-0.8.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7a46e5ff292c356d6991e60942ba7f79817682d3a2cef0702136448cb9c4d235", size = 502844, upload-time = "2026-06-09T07:52:07.624Z" },
+ { url = "https://files.pythonhosted.org/packages/91/4f/3175c9d75634e0e0dda0082794193521035edd7c70a6f212bf33ca06ddf4/safetensors-0.8.0-cp310-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4124502b78f03534117c848f87a39b8f31e577b15eff423bf8bfb95f2a8c30d0", size = 511823, upload-time = "2026-06-09T07:52:09.565Z" },
+ { url = "https://files.pythonhosted.org/packages/20/87/846c289e7aa2299eff406335717cf43ce8777194ece8aad75772e0411615/safetensors-0.8.0-cp310-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7bc0a787ba8a35be368ee3574edfa2b1ad389eebd0a72e482ae275490e3f6c98", size = 633461, upload-time = "2026-06-09T07:52:11.128Z" },
+ { url = "https://files.pythonhosted.org/packages/76/22/8d64d9df2c45d5ded401df889d0ad90882804ca172d79ec4f0df8f727fe0/safetensors-0.8.0-cp310-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:040070828e36dc8e122178bbbd5830ff9e97920affb84cbe0f46442497bed358", size = 545148, upload-time = "2026-06-09T07:52:13.603Z" },
+ { url = "https://files.pythonhosted.org/packages/28/50/f203ff3a3ddfe19308efc83c5a3a29ed02bf786732ec35e68bf9162f3365/safetensors-0.8.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd6f3f93c9a0a7cc2788ee63fb763353d4bd2e89b0751bc78fcf7dda00bea774", size = 516040, upload-time = "2026-06-09T07:52:16.29Z" },
+ { url = "https://files.pythonhosted.org/packages/46/fb/cdaed17ceb2948784fd9c36b6fd3e951b608547cea81a48e8ee6f8cfdfcb/safetensors-0.8.0-cp310-abi3-manylinux_2_31_riscv64.whl", hash = "sha256:fcdd41ec4628fee5799f807c73c353629130fbd942aa23d83c623dd6c9d52d78", size = 513832, upload-time = "2026-06-09T07:52:12.37Z" },
+ { url = "https://files.pythonhosted.org/packages/0d/49/1e15de264dcc3b77943d2d0c56a95809956883b1c2d6d585c792523f180b/safetensors-0.8.0-cp310-abi3-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8e9f537aa183a38ace122d27303dcd986b26bd2a7591f9181d7f0c396f4677ca", size = 559930, upload-time = "2026-06-09T07:52:14.743Z" },
+ { url = "https://files.pythonhosted.org/packages/2a/43/bf38443278eab4b1be1fce2931e2b012ad9cb7df52ada751d0aab8f7659a/safetensors-0.8.0-cp310-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:87eec7ffed2b809f05a398a8becb7d013f19f7837cd15d9748580d6cf30dbaf4", size = 678670, upload-time = "2026-06-09T07:52:20.032Z" },
+ { url = "https://files.pythonhosted.org/packages/72/e3/68cd3fa5b48488e84add63e04cb12f3bc28ae4638c06d4508c6e88823d0e/safetensors-0.8.0-cp310-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:4a95ae2b05d7726d751da4ebf626a2ca782b706e101bd894c95bc2450b1cffcc", size = 786679, upload-time = "2026-06-09T07:52:21.322Z" },
+ { url = "https://files.pythonhosted.org/packages/29/4b/1c19c509d56e01f4fbb3d0a2e597450f6cc04d1d56cf52defb0a62dfd715/safetensors-0.8.0-cp310-abi3-musllinux_1_2_i686.whl", hash = "sha256:3ae091f16662658bdc019a4ff6cb4c085bb7d725eb5978b183ffd265863b6d2d", size = 765683, upload-time = "2026-06-09T07:52:22.594Z" },
+ { url = "https://files.pythonhosted.org/packages/27/43/41c1621732edd934d868a00d1b891584c892a7b62a9aab82ea5a0a5623ee/safetensors-0.8.0-cp310-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:8e080062fcde23be189565e1c3305d16751a218ecf9412c8601e64204eb6f846", size = 722361, upload-time = "2026-06-09T07:52:23.924Z" },
+ { url = "https://files.pythonhosted.org/packages/8e/3f/73ccf82579412b4a71c4ca673f10b5f1f888d7cf5af7fe24f27d30307be4/safetensors-0.8.0-cp310-abi3-win32.whl", hash = "sha256:2ddf52eac562eda224f99acfa7889d02968c1fd59a5b011ae7d8137c37e9c02d", size = 342401, upload-time = "2026-06-09T07:52:28.895Z" },
+ { url = "https://files.pythonhosted.org/packages/1b/6d/3fba214c1e5e0f69991677ec3bc17023f0421776975e1de0c682dca475e2/safetensors-0.8.0-cp310-abi3-win_amd64.whl", hash = "sha256:096ec1a98435df7beb08853bb5aa9081a84f23d0adc67ed1a0a10550f608373f", size = 355540, upload-time = "2026-06-09T07:52:27.832Z" },
+ { url = "https://files.pythonhosted.org/packages/8d/fc/7eedc3510d97878876e32774eebbeb61c43f148a96e915c84229a3e967aa/safetensors-0.8.0-cp310-abi3-win_arm64.whl", hash = "sha256:f7838e5135a406ad3e02efdcb8cf2e5397d368b0154537c4fec682dbc544d452", size = 340500, upload-time = "2026-06-09T07:52:26.745Z" },
]
[[package]]
@@ -2341,6 +2344,15 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/ec/bf/cb6c1c505cb31e818e900b9312d514f381fbfa5c4363edfce0fcc4f8c1a4/shapely-2.1.2-cp312-cp312-win_amd64.whl", hash = "sha256:743044b4cfb34f9a67205cee9279feaf60ba7d02e69febc2afc609047cb49179", size = 1722861, upload-time = "2025-09-24T13:50:43.35Z" },
]
+[[package]]
+name = "shellingham"
+version = "1.5.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
+]
+
[[package]]
name = "six"
version = "1.17.0"
@@ -2459,27 +2471,28 @@ wheels = [
[[package]]
name = "tokenizers"
-version = "0.21.4"
+version = "0.22.2"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "huggingface-hub" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/c2/2f/402986d0823f8d7ca139d969af2917fefaa9b947d1fb32f6168c509f2492/tokenizers-0.21.4.tar.gz", hash = "sha256:fa23f85fbc9a02ec5c6978da172cdcbac23498c3ca9f3645c5c68740ac007880", size = 351253, upload-time = "2025-07-28T15:48:54.325Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/73/6f/f80cfef4a312e1fb34baf7d85c72d4411afde10978d4657f8cdd811d3ccc/tokenizers-0.22.2.tar.gz", hash = "sha256:473b83b915e547aa366d1eee11806deaf419e17be16310ac0a14077f1e28f917", size = 372115, upload-time = "2026-01-05T10:45:15.988Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/98/c6/fdb6f72bf6454f52eb4a2510be7fb0f614e541a2554d6210e370d85efff4/tokenizers-0.21.4-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:2ccc10a7c3bcefe0f242867dc914fc1226ee44321eb618cfe3019b5df3400133", size = 2863987, upload-time = "2025-07-28T15:48:44.877Z" },
- { url = "https://files.pythonhosted.org/packages/8d/a6/28975479e35ddc751dc1ddc97b9b69bf7fcf074db31548aab37f8116674c/tokenizers-0.21.4-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:5e2f601a8e0cd5be5cc7506b20a79112370b9b3e9cb5f13f68ab11acd6ca7d60", size = 2732457, upload-time = "2025-07-28T15:48:43.265Z" },
- { url = "https://files.pythonhosted.org/packages/aa/8f/24f39d7b5c726b7b0be95dca04f344df278a3fe3a4deb15a975d194cbb32/tokenizers-0.21.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:39b376f5a1aee67b4d29032ee85511bbd1b99007ec735f7f35c8a2eb104eade5", size = 3012624, upload-time = "2025-07-28T13:22:43.895Z" },
- { url = "https://files.pythonhosted.org/packages/58/47/26358925717687a58cb74d7a508de96649544fad5778f0cd9827398dc499/tokenizers-0.21.4-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2107ad649e2cda4488d41dfd031469e9da3fcbfd6183e74e4958fa729ffbf9c6", size = 2939681, upload-time = "2025-07-28T13:22:47.499Z" },
- { url = "https://files.pythonhosted.org/packages/99/6f/cc300fea5db2ab5ddc2c8aea5757a27b89c84469899710c3aeddc1d39801/tokenizers-0.21.4-cp39-abi3-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:3c73012da95afafdf235ba80047699df4384fdc481527448a078ffd00e45a7d9", size = 3247445, upload-time = "2025-07-28T15:48:39.711Z" },
- { url = "https://files.pythonhosted.org/packages/be/bf/98cb4b9c3c4afd8be89cfa6423704337dc20b73eb4180397a6e0d456c334/tokenizers-0.21.4-cp39-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f23186c40395fc390d27f519679a58023f368a0aad234af145e0f39ad1212732", size = 3428014, upload-time = "2025-07-28T13:22:49.569Z" },
- { url = "https://files.pythonhosted.org/packages/75/c7/96c1cc780e6ca7f01a57c13235dd05b7bc1c0f3588512ebe9d1331b5f5ae/tokenizers-0.21.4-cp39-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:cc88bb34e23a54cc42713d6d98af5f1bf79c07653d24fe984d2d695ba2c922a2", size = 3193197, upload-time = "2025-07-28T13:22:51.471Z" },
- { url = "https://files.pythonhosted.org/packages/f2/90/273b6c7ec78af547694eddeea9e05de771278bd20476525ab930cecaf7d8/tokenizers-0.21.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51b7eabb104f46c1c50b486520555715457ae833d5aee9ff6ae853d1130506ff", size = 3115426, upload-time = "2025-07-28T15:48:41.439Z" },
- { url = "https://files.pythonhosted.org/packages/91/43/c640d5a07e95f1cf9d2c92501f20a25f179ac53a4f71e1489a3dcfcc67ee/tokenizers-0.21.4-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:714b05b2e1af1288bd1bc56ce496c4cebb64a20d158ee802887757791191e6e2", size = 9089127, upload-time = "2025-07-28T15:48:46.472Z" },
- { url = "https://files.pythonhosted.org/packages/44/a1/dd23edd6271d4dca788e5200a807b49ec3e6987815cd9d0a07ad9c96c7c2/tokenizers-0.21.4-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:1340ff877ceedfa937544b7d79f5b7becf33a4cfb58f89b3b49927004ef66f78", size = 9055243, upload-time = "2025-07-28T15:48:48.539Z" },
- { url = "https://files.pythonhosted.org/packages/21/2b/b410d6e9021c4b7ddb57248304dc817c4d4970b73b6ee343674914701197/tokenizers-0.21.4-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:3c1f4317576e465ac9ef0d165b247825a2a4078bcd01cba6b54b867bdf9fdd8b", size = 9298237, upload-time = "2025-07-28T15:48:50.443Z" },
- { url = "https://files.pythonhosted.org/packages/b7/0a/42348c995c67e2e6e5c89ffb9cfd68507cbaeb84ff39c49ee6e0a6dd0fd2/tokenizers-0.21.4-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:c212aa4e45ec0bb5274b16b6f31dd3f1c41944025c2358faaa5782c754e84c24", size = 9461980, upload-time = "2025-07-28T15:48:52.325Z" },
- { url = "https://files.pythonhosted.org/packages/3d/d3/dacccd834404cd71b5c334882f3ba40331ad2120e69ded32cf5fda9a7436/tokenizers-0.21.4-cp39-abi3-win32.whl", hash = "sha256:6c42a930bc5f4c47f4ea775c91de47d27910881902b0f20e4990ebe045a415d0", size = 2329871, upload-time = "2025-07-28T15:48:56.841Z" },
- { url = "https://files.pythonhosted.org/packages/41/f2/fd673d979185f5dcbac4be7d09461cbb99751554ffb6718d0013af8604cb/tokenizers-0.21.4-cp39-abi3-win_amd64.whl", hash = "sha256:475d807a5c3eb72c59ad9b5fcdb254f6e17f53dfcbb9903233b0dfa9c943b597", size = 2507568, upload-time = "2025-07-28T15:48:55.456Z" },
+ { url = "https://files.pythonhosted.org/packages/92/97/5dbfabf04c7e348e655e907ed27913e03db0923abb5dfdd120d7b25630e1/tokenizers-0.22.2-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:544dd704ae7238755d790de45ba8da072e9af3eea688f698b137915ae959281c", size = 3100275, upload-time = "2026-01-05T10:41:02.158Z" },
+ { url = "https://files.pythonhosted.org/packages/2e/47/174dca0502ef88b28f1c9e06b73ce33500eedfac7a7692108aec220464e7/tokenizers-0.22.2-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:1e418a55456beedca4621dbab65a318981467a2b188e982a23e117f115ce5001", size = 2981472, upload-time = "2026-01-05T10:41:00.276Z" },
+ { url = "https://files.pythonhosted.org/packages/d6/84/7990e799f1309a8b87af6b948f31edaa12a3ed22d11b352eaf4f4b2e5753/tokenizers-0.22.2-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2249487018adec45d6e3554c71d46eb39fa8ea67156c640f7513eb26f318cec7", size = 3290736, upload-time = "2026-01-05T10:40:32.165Z" },
+ { url = "https://files.pythonhosted.org/packages/78/59/09d0d9ba94dcd5f4f1368d4858d24546b4bdc0231c2354aa31d6199f0399/tokenizers-0.22.2-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:25b85325d0815e86e0bac263506dd114578953b7b53d7de09a6485e4a160a7dd", size = 3168835, upload-time = "2026-01-05T10:40:38.847Z" },
+ { url = "https://files.pythonhosted.org/packages/47/50/b3ebb4243e7160bda8d34b731e54dd8ab8b133e50775872e7a434e524c28/tokenizers-0.22.2-cp39-abi3-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:bfb88f22a209ff7b40a576d5324bf8286b519d7358663db21d6246fb17eea2d5", size = 3521673, upload-time = "2026-01-05T10:40:56.614Z" },
+ { url = "https://files.pythonhosted.org/packages/e0/fa/89f4cb9e08df770b57adb96f8cbb7e22695a4cb6c2bd5f0c4f0ebcf33b66/tokenizers-0.22.2-cp39-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1c774b1276f71e1ef716e5486f21e76333464f47bece56bbd554485982a9e03e", size = 3724818, upload-time = "2026-01-05T10:40:44.507Z" },
+ { url = "https://files.pythonhosted.org/packages/64/04/ca2363f0bfbe3b3d36e95bf67e56a4c88c8e3362b658e616d1ac185d47f2/tokenizers-0.22.2-cp39-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:df6c4265b289083bf710dff49bc51ef252f9d5be33a45ee2bed151114a56207b", size = 3379195, upload-time = "2026-01-05T10:40:51.139Z" },
+ { url = "https://files.pythonhosted.org/packages/2e/76/932be4b50ef6ccedf9d3c6639b056a967a86258c6d9200643f01269211ca/tokenizers-0.22.2-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:369cc9fc8cc10cb24143873a0d95438bb8ee257bb80c71989e3ee290e8d72c67", size = 3274982, upload-time = "2026-01-05T10:40:58.331Z" },
+ { url = "https://files.pythonhosted.org/packages/1d/28/5f9f5a4cc211b69e89420980e483831bcc29dade307955cc9dc858a40f01/tokenizers-0.22.2-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:29c30b83d8dcd061078b05ae0cb94d3c710555fbb44861139f9f83dcca3dc3e4", size = 9478245, upload-time = "2026-01-05T10:41:04.053Z" },
+ { url = "https://files.pythonhosted.org/packages/6c/fb/66e2da4704d6aadebf8cb39f1d6d1957df667ab24cff2326b77cda0dcb85/tokenizers-0.22.2-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:37ae80a28c1d3265bb1f22464c856bd23c02a05bb211e56d0c5301a435be6c1a", size = 9560069, upload-time = "2026-01-05T10:45:10.673Z" },
+ { url = "https://files.pythonhosted.org/packages/16/04/fed398b05caa87ce9b1a1bb5166645e38196081b225059a6edaff6440fac/tokenizers-0.22.2-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:791135ee325f2336f498590eb2f11dc5c295232f288e75c99a36c5dbce63088a", size = 9899263, upload-time = "2026-01-05T10:45:12.559Z" },
+ { url = "https://files.pythonhosted.org/packages/05/a1/d62dfe7376beaaf1394917e0f8e93ee5f67fea8fcf4107501db35996586b/tokenizers-0.22.2-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:38337540fbbddff8e999d59970f3c6f35a82de10053206a7562f1ea02d046fa5", size = 10033429, upload-time = "2026-01-05T10:45:14.333Z" },
+ { url = "https://files.pythonhosted.org/packages/fd/18/a545c4ea42af3df6effd7d13d250ba77a0a86fb20393143bbb9a92e434d4/tokenizers-0.22.2-cp39-abi3-win32.whl", hash = "sha256:a6bf3f88c554a2b653af81f3204491c818ae2ac6fbc09e76ef4773351292bc92", size = 2502363, upload-time = "2026-01-05T10:45:20.593Z" },
+ { url = "https://files.pythonhosted.org/packages/65/71/0670843133a43d43070abeb1949abfdef12a86d490bea9cd9e18e37c5ff7/tokenizers-0.22.2-cp39-abi3-win_amd64.whl", hash = "sha256:c9ea31edff2968b44a88f97d784c2f16dc0729b8b143ed004699ebca91f05c48", size = 2747786, upload-time = "2026-01-05T10:45:18.411Z" },
+ { url = "https://files.pythonhosted.org/packages/72/f4/0de46cfa12cdcbcd464cc59fde36912af405696f687e53a091fb432f694c/tokenizers-0.22.2-cp39-abi3-win_arm64.whl", hash = "sha256:9ce725d22864a1e965217204946f830c37876eee3b2ba6fc6255e8e903d5fcbc", size = 2612133, upload-time = "2026-01-05T10:45:17.232Z" },
]
[[package]]
@@ -2647,23 +2660,22 @@ wheels = [
[[package]]
name = "transformers"
-version = "4.49.0"
+version = "5.3.0"
source = { registry = "https://pypi.org/simple" }
dependencies = [
- { name = "filelock" },
{ name = "huggingface-hub" },
{ name = "numpy" },
{ name = "packaging" },
{ name = "pyyaml" },
{ name = "regex" },
- { name = "requests" },
{ name = "safetensors" },
{ name = "tokenizers" },
{ name = "tqdm" },
+ { name = "typer" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/79/50/46573150944f46df8ec968eda854023165a84470b42f69f67c7d475dabc5/transformers-4.49.0.tar.gz", hash = "sha256:7e40e640b5b8dc3f48743f5f5adbdce3660c82baafbd3afdfc04143cdbd2089e", size = 8610952, upload-time = "2025-02-17T15:19:03.614Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/fc/1a/70e830d53ecc96ce69cfa8de38f163712d2b43ac52fbd743f39f56025c31/transformers-5.3.0.tar.gz", hash = "sha256:009555b364029da9e2946d41f1c5de9f15e6b1df46b189b7293f33a161b9c557", size = 8830831, upload-time = "2026-03-04T17:41:46.119Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/20/37/1f29af63e9c30156a3ed6ebc2754077016577c094f31de7b2631e5d379eb/transformers-4.49.0-py3-none-any.whl", hash = "sha256:6b4fded1c5fee04d384b1014495b4235a2b53c87503d7d592423c06128cbbe03", size = 9970275, upload-time = "2025-02-17T15:18:58.814Z" },
+ { url = "https://files.pythonhosted.org/packages/b8/88/ae8320064e32679a5429a2c9ebbc05c2bf32cefb6e076f9b07f6d685a9b4/transformers-5.3.0-py3-none-any.whl", hash = "sha256:50ac8c89c3c7033444fb3f9f53138096b997ebb70d4b5e50a2e810bf12d3d29a", size = 10661827, upload-time = "2026-03-04T17:41:42.722Z" },
]
[[package]]
@@ -2677,6 +2689,21 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/d0/66/b1eb52839f563623d185f0927eb3530ee4d5ffe9d377cdaf5346b306689e/triton-3.4.0-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:31c1d84a5c0ec2c0f8e8a072d7fd150cab84a9c239eaddc6706c081bfae4eb04", size = 155560068, upload-time = "2025-07-30T19:58:37.081Z" },
]
+[[package]]
+name = "typer"
+version = "0.26.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+ { name = "annotated-doc" },
+ { name = "colorama", marker = "sys_platform == 'win32'" },
+ { name = "rich" },
+ { name = "shellingham" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/7c/f7/68adc395201b20b872d68e975386832e8005ffeacedd43a1d837a32815be/typer-0.26.8.tar.gz", hash = "sha256:c244a6bd558886fe3f8780efb6bdd28bb9aff005a94eedebaa5cb32926fe2f7e", size = 202097, upload-time = "2026-06-26T09:22:45.705Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/80/87/b9fd69c92c6102a066e1b86a35243f53e70bd4c709f2a26d9f4fee4f4dc0/typer-0.26.8-py3-none-any.whl", hash = "sha256:3512ca79ac5c11113414b36e80281b872884477722440691c89d1112e321a49c", size = 122564, upload-time = "2026-06-26T09:22:44.72Z" },
+]
+
[[package]]
name = "typing-extensions"
version = "4.15.0"
diff --git a/docs/guides/hardware-acceleration.md b/docs/guides/hardware-acceleration.md
index 03e6605d..b58762bd 100644
--- a/docs/guides/hardware-acceleration.md
+++ b/docs/guides/hardware-acceleration.md
@@ -30,7 +30,7 @@ degrades to "not available" rather than raising:
- **ONNX Runtime execution providers** — CUDA, ROCm, CoreML (Apple), DirectML
(Windows). Used by the face-detection pipeline (InsightFace / ONNX).
- **PyTorch devices** — CUDA and MPS (Apple Metal). Used by the embedding
- (open_clip / SigLIP), captioning (Florence-2), and object-detection (YOLO)
+ (open_clip / SigLIP), captioning (BLIP), and object-detection (YOLO)
pipelines.
- **CPU** — always present as the floor.
diff --git a/docs/guides/real-ml-troubleshooting.md b/docs/guides/real-ml-troubleshooting.md
index 97cca72f..8d576426 100644
--- a/docs/guides/real-ml-troubleshooting.md
+++ b/docs/guides/real-ml-troubleshooting.md
@@ -90,7 +90,7 @@ Check:
## Common causes
-* Florence-2 model failed to load
+* BLIP caption model failed to load
* empty inference response
* unsupported/corrupted image
* model download interruption
From 125ba262fd2c4a253b32bc760f2583c7e5513bed Mon Sep 17 00:00:00 2001
From: Abhash Chakraborty
<80592559+Abhash-Chakraborty@users.noreply.github.com>
Date: Tue, 14 Jul 2026 13:57:09 +0530
Subject: [PATCH 09/21] fix: harden runtime and media paths
---
.github/workflows/publish.yml | 7 +++-
backend/src/find_api/core/model_manager.py | 3 ++
backend/src/find_api/core/sqlite_queue.py | 8 ++--
backend/src/find_api/routers/auth.py | 6 ++-
backend/src/find_api/workers/rq_worker.py | 39 +++++++++++++++++++
backend/tests/test_rq_worker.py | 35 +++++++++++++++++
compose.base.yml | 6 +--
frontend/biome.json | 3 ++
frontend/src/app/gallery/page.tsx | 33 +++++++++++++---
frontend/src/components/justified-grid.tsx | 19 ++++++---
.../src/components/timeline-media-view.tsx | 9 +++--
11 files changed, 143 insertions(+), 25 deletions(-)
create mode 100644 backend/src/find_api/workers/rq_worker.py
create mode 100644 backend/tests/test_rq_worker.py
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 197ed70a..a33b75fe 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -23,7 +23,6 @@ on:
permissions:
contents: read
- packages: write
concurrency:
group: publish-${{ github.ref }}-${{ inputs.image_tag || github.ref_name }}
@@ -70,6 +69,9 @@ jobs:
name: Publish backend (${{ matrix.profile }})
needs: metadata
runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ packages: write
strategy:
fail-fast: false
matrix:
@@ -120,6 +122,9 @@ jobs:
name: Publish web image
needs: metadata
runs-on: ubuntu-latest
+ permissions:
+ contents: read
+ packages: write
steps:
- name: Check out source
uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5
diff --git a/backend/src/find_api/core/model_manager.py b/backend/src/find_api/core/model_manager.py
index 6c49f002..4874b608 100644
--- a/backend/src/find_api/core/model_manager.py
+++ b/backend/src/find_api/core/model_manager.py
@@ -121,6 +121,9 @@ def cleanup_loop():
try:
time.sleep(interval_seconds)
self.unload_idle_models(ttl_seconds)
+ # Keep the process heartbeat fresh even when no models
+ # are loaded and the worker is otherwise idle.
+ self.publish_status()
except Exception as e:
logger.error(f"Error in model cleanup thread: {e}")
diff --git a/backend/src/find_api/core/sqlite_queue.py b/backend/src/find_api/core/sqlite_queue.py
index 6052ba4c..e976e38f 100644
--- a/backend/src/find_api/core/sqlite_queue.py
+++ b/backend/src/find_api/core/sqlite_queue.py
@@ -39,7 +39,7 @@
WHERE id = (
SELECT id FROM job_queue
WHERE status = 'queued'
- ORDER BY created_at ASC
+ ORDER BY created_at ASC, rowid ASC
LIMIT 1
)
RETURNING id, type, payload, created_at
@@ -67,14 +67,14 @@
SELECT id, type, status, payload, error_info, created_at, started_at, completed_at
FROM job_queue
WHERE status IN ('queued', 'running')
-ORDER BY created_at ASC
+ORDER BY created_at ASC, rowid ASC
"""
SQL_LIST_FAILED = """
SELECT id, type, status, payload, error_info, created_at, started_at, completed_at
FROM job_queue
WHERE status = 'failed'
-ORDER BY completed_at DESC
+ORDER BY completed_at DESC, rowid DESC
"""
SQL_COUNT_STATUS = """
@@ -88,7 +88,7 @@
SQL_RESET_STALE = """
UPDATE job_queue
SET status = 'queued', started_at = NULL, error_info = ?
-WHERE status = 'running' AND started_at < ?
+WHERE status = 'running' AND started_at <= ?
"""
SQL_CREATE_CLUSTERING_LOCKS = """
diff --git a/backend/src/find_api/routers/auth.py b/backend/src/find_api/routers/auth.py
index 60f7f8b8..877e3e8b 100644
--- a/backend/src/find_api/routers/auth.py
+++ b/backend/src/find_api/routers/auth.py
@@ -294,7 +294,11 @@ def update_profile(
if body.display_name is not None:
user.display_name = body.display_name.strip() or None
- db.commit()
+ try:
+ db.commit()
+ except IntegrityError as exc:
+ db.rollback()
+ raise HTTPException(409, "Username is already in use") from exc
db.refresh(user)
return {"user": _user_dict(user)}
diff --git a/backend/src/find_api/workers/rq_worker.py b/backend/src/find_api/workers/rq_worker.py
new file mode 100644
index 00000000..0c990be0
--- /dev/null
+++ b/backend/src/find_api/workers/rq_worker.py
@@ -0,0 +1,39 @@
+"""RQ worker integration for idle health and applied-runtime reporting."""
+
+import logging
+from typing import Any
+
+from rq.worker.worker_classes import SimpleWorker
+
+from find_api.core.config import settings
+from find_api.core.database import SessionLocal
+from find_api.core.model_manager import get_model_manager
+from find_api.core.runtime_profile import load_runtime_preferences, resolve_runtime
+
+logger = logging.getLogger(__name__)
+
+
+def initialize_worker_observability() -> None:
+ """Publish worker health before the first queued job is received."""
+ try:
+ manager = get_model_manager()
+ manager.start_autocleanup(
+ ttl_seconds=settings.ML_MODEL_IDLE_TTL_SECONDS,
+ process_name="worker",
+ )
+ with SessionLocal() as db:
+ runtime = resolve_runtime(load_runtime_preferences(db))
+ manager.set_runtime_status(runtime.to_worker_status(source="database"))
+ except Exception: # noqa: BLE001
+ # Queue availability is more important than observability during a
+ # transient database/Redis startup race. The first job retries this
+ # runtime publication through ``_begin_worker_runtime``.
+ logger.exception("Failed to initialize worker runtime observability")
+
+
+class FindWorker(SimpleWorker):
+ """SimpleWorker that reports healthy state while waiting for work."""
+
+ def work(self, *args: Any, **kwargs: Any) -> bool:
+ initialize_worker_observability()
+ return super().work(*args, **kwargs)
diff --git a/backend/tests/test_rq_worker.py b/backend/tests/test_rq_worker.py
new file mode 100644
index 00000000..1869afa6
--- /dev/null
+++ b/backend/tests/test_rq_worker.py
@@ -0,0 +1,35 @@
+"""Tests for RQ worker startup observability."""
+
+from unittest.mock import MagicMock, Mock, patch
+
+from find_api.workers.rq_worker import initialize_worker_observability
+
+
+def test_worker_publishes_runtime_before_first_job():
+ manager = Mock()
+ session = Mock()
+ session_factory = MagicMock()
+ session_factory.return_value.__enter__.return_value = session
+ preferences = Mock()
+ runtime = Mock()
+ runtime.to_worker_status.return_value = {"applied_mode": "full"}
+
+ with (
+ patch(
+ "find_api.workers.rq_worker.get_model_manager",
+ return_value=manager,
+ ),
+ patch("find_api.workers.rq_worker.SessionLocal", session_factory),
+ patch(
+ "find_api.workers.rq_worker.load_runtime_preferences",
+ return_value=preferences,
+ ),
+ patch(
+ "find_api.workers.rq_worker.resolve_runtime",
+ return_value=runtime,
+ ),
+ ):
+ initialize_worker_observability()
+
+ manager.start_autocleanup.assert_called_once()
+ manager.set_runtime_status.assert_called_once_with({"applied_mode": "full"})
diff --git a/compose.base.yml b/compose.base.yml
index 136ad5ec..ddacdb49 100644
--- a/compose.base.yml
+++ b/compose.base.yml
@@ -59,7 +59,7 @@ services:
UV_SYNC_EXTRAS: ""
command: uvicorn find_api.main:app --host 0.0.0.0 --port 8000 --log-level warning
ports:
- - "8000:8000"
+ - "127.0.0.1:8000:8000"
environment: &backend-environment
DATABASE_URL: ${DATABASE_URL}
MINIO_ENDPOINT: ${MINIO_ENDPOINT:-minio:9000}
@@ -102,7 +102,7 @@ services:
PYTHON_VERSION: "3.12"
FIND_BUILD_PROFILE: no-ai
UV_SYNC_EXTRAS: ""
- command: rq worker --worker-class ${RQ_WORKER_CLASS:-rq.worker.worker_classes.SimpleWorker} --url ${REDIS_URL:-redis://:find-redis-dev@redis:6379} high default low
+ command: rq worker --worker-class find_api.workers.rq_worker.FindWorker --url ${REDIS_URL} high default low
environment:
<<: *backend-environment
MODEL_MANAGER_PROCESS_NAME: worker
@@ -123,7 +123,7 @@ services:
dockerfile: Dockerfile
target: production
ports:
- - "3000:3000"
+ - "127.0.0.1:3000:3000"
environment:
NEXT_PUBLIC_API_URL: http://localhost:8000
NEXT_PUBLIC_MINIO_BUCKET: ${NEXT_PUBLIC_MINIO_BUCKET:-images}
diff --git a/frontend/biome.json b/frontend/biome.json
index ea453fdf..e9604f23 100644
--- a/frontend/biome.json
+++ b/frontend/biome.json
@@ -21,6 +21,9 @@
"clientKind": "git",
"useIgnoreFile": true
},
+ "files": {
+ "includes": ["**", "!!src-tauri/gen", "!!src-tauri/target"]
+ },
"formatter": {
"enabled": true,
"indentStyle": "space",
diff --git a/frontend/src/app/gallery/page.tsx b/frontend/src/app/gallery/page.tsx
index 61f983e1..8d64cce4 100644
--- a/frontend/src/app/gallery/page.tsx
+++ b/frontend/src/app/gallery/page.tsx
@@ -839,6 +839,24 @@ function GalleryPageContent() {
},
});
+ const downloadMutation = useMutation({
+ mutationFn: async (item: { id: number; filename: string }) => {
+ const response = await api.get(`/api/image/${item.id}/original`, {
+ responseType: "blob",
+ });
+ const objectUrl = URL.createObjectURL(response.data);
+ try {
+ const anchor = document.createElement("a");
+ anchor.href = objectUrl;
+ anchor.download = item.filename;
+ anchor.click();
+ } finally {
+ URL.revokeObjectURL(objectUrl);
+ }
+ },
+ onError: () => toast.error("Download failed. Please try again."),
+ });
+
const moveToVaultMutation = useMutation({
mutationFn: async (mediaId: number) => {
if (!vaultSessionToken) {
@@ -1313,17 +1331,20 @@ function GalleryPageContent() {
}`}
/>
-
+ downloadMutation.mutate({
+ id: item.id,
+ filename: item.filename,
+ })
}
- download={item.filename}
+ disabled={downloadMutation.isPending}
className="icon-button h-8 w-8"
aria-label="Download image"
>
+
{(item.status === "failed" ||
(item.status === "indexed" && !item.caption)) && (
{
className?: string;
getKey: (item: T, index: number) => string | number;
renderItem: (item: T, index: number, box: JustifiedBox) => ReactNode;
+ scrollContainerRef?: RefObject;
}
const DEFAULT_TARGET_ROW_HEIGHT = 235;
@@ -56,6 +58,7 @@ export function JustifiedGrid({
className,
getKey,
renderItem,
+ scrollContainerRef,
}: JustifiedGridProps) {
const containerRef = useRef(null);
const [containerWidth, setContainerWidth] = useState(0);
@@ -89,24 +92,28 @@ export function JustifiedGrid({
if (typeof window === "undefined") {
return;
}
+ const scrollContainer = scrollContainerRef?.current;
const update = () => {
const element = containerRef.current;
if (!element) {
return;
}
const rect = element.getBoundingClientRect();
- // How far the grid's top has scrolled above the viewport top.
- setScrollTop(Math.max(0, -rect.top));
- setViewportHeight(window.innerHeight || 0);
+ const viewportTop = scrollContainer?.getBoundingClientRect().top ?? 0;
+ setScrollTop(Math.max(0, viewportTop - rect.top));
+ setViewportHeight(
+ scrollContainer?.clientHeight ?? window.innerHeight ?? 0,
+ );
};
update();
- window.addEventListener("scroll", update, { passive: true });
+ const scrollTarget = scrollContainer ?? window;
+ scrollTarget.addEventListener("scroll", update, { passive: true });
window.addEventListener("resize", update);
return () => {
- window.removeEventListener("scroll", update);
+ scrollTarget.removeEventListener("scroll", update);
window.removeEventListener("resize", update);
};
- }, []);
+ }, [scrollContainerRef]);
const layout = useMemo(
() =>
diff --git a/frontend/src/components/timeline-media-view.tsx b/frontend/src/components/timeline-media-view.tsx
index a57d98d5..fe244569 100644
--- a/frontend/src/components/timeline-media-view.tsx
+++ b/frontend/src/components/timeline-media-view.tsx
@@ -93,7 +93,7 @@ export function TimelineMediaView({
getHeight = () => null,
getThumbnailUrl,
getOriginalUrl,
- getAlt = () => "",
+ getAlt,
getOpenLabel,
getItemTestId,
getOpenTestId,
@@ -145,7 +145,7 @@ export function TimelineMediaView({
return {
id,
thumbnailUrl,
- alt: getAlt(item),
+ alt: getAlt?.(item),
// View-only shares deliberately fall back to their share-scoped
// thumbnail; a private route is never synthesized here.
originalUrl: resolveApiRoute(rawOriginalUrl) ?? thumbnailUrl,
@@ -304,6 +304,7 @@ export function TimelineMediaView({
({
item,
ratio: mediaAspectRatio(getWidth(item), getHeight(item)),
@@ -325,7 +326,7 @@ export function TimelineMediaView({
data-testid={getOpenTestId?.(item)}
aria-label={
getOpenLabel?.(item) ??
- `Open ${getAlt(item) || "image"}`
+ `Open ${getAlt?.(item) || "image"}`
}
onClick={() => {
if (onOpenItem) onOpenItem(item, timelineIndex);
@@ -337,7 +338,7 @@ export function TimelineMediaView({
// biome-ignore lint/performance/noImgElement: authenticated and share-scoped media URLs are not Next image assets.
(null);
+ const [pendingRestoreIds, setPendingRestoreIds] = useState>(
+ () => new Set(),
+ );
+ const [lockMode, setLockMode] = useState<"immediate" | "delay" | "idle">(
+ () => {
+ try {
+ const saved = localStorage.getItem("find-vault-lock-mode");
+ return saved === "delay" || saved === "idle" ? saved : "immediate";
+ } catch {
+ return "immediate";
+ }
+ },
+ );
+ const [lockDelay, setLockDelay] = useState(() => {
+ try {
+ return Number(localStorage.getItem("find-vault-lock-delay")) || 5;
+ } catch {
+ return 5;
+ }
+ });
+ const [newRecoveryCode, setNewRecoveryCode] = useState(null);
const [thumbnailUrls, setThumbnailUrls] = useState>(
{},
);
@@ -211,7 +240,7 @@ export function VaultGallery() {
return;
}
setSessionMessage(
- "Some encrypted previews could not be loaded. You can retry shortly.",
+ "Some private previews could not be loaded. You can retry shortly.",
);
}
}
@@ -235,10 +264,16 @@ export function VaultGallery() {
if (!sessionToken) {
throw new Error("Vault session missing");
}
+ setPendingRestoreIds((current) => new Set(current).add(mediaId));
await restoreVaultItem(mediaId, sessionToken);
return mediaId;
},
onSuccess: async (mediaId) => {
+ setPendingRestoreIds((current) => {
+ const next = new Set(current);
+ next.delete(mediaId);
+ return next;
+ });
const thumbnailUrl = objectUrlsRef.current[mediaId];
if (thumbnailUrl) {
URL.revokeObjectURL(thumbnailUrl);
@@ -248,15 +283,36 @@ export function VaultGallery() {
setSessionMessage("Image restored to your timeline.");
await queryClient.invalidateQueries({ queryKey: VAULT_QUERY_KEY });
},
- onError: (error) => {
+ onError: (error, mediaId) => {
+ setPendingRestoreIds((current) => {
+ const next = new Set(current);
+ next.delete(mediaId);
+ return next;
+ });
if (isExpiredVaultSession(error)) {
clearSession("Session expired. Please unlock again.");
return;
}
setSessionMessage(
- "The image could not be restored. Its encrypted copy is still safe.",
+ "The image could not be restored. Its private vault copy is unchanged.",
+ );
+ },
+ });
+
+ const passwordMutation = useMutation({
+ mutationFn: ({ current, next }: { current: string; next: string }) =>
+ changeVaultPassword(current, next),
+ onSuccess: ({ session_token, recovery_code }) => {
+ vaultStore.getState().unlock(session_token);
+ setNewRecoveryCode(recovery_code);
+ setSessionMessage(
+ "Vault password updated. Save the new recovery code below.",
);
},
+ onError: () =>
+ setSessionMessage(
+ "Vault password could not be changed. Check the current password.",
+ ),
});
const handleLock = useCallback(() => {
@@ -277,9 +333,41 @@ export function VaultGallery() {
}
}, [queryClient, revokeThumbnails, sessionToken]);
+ useEffect(() => {
+ if (!isUnlocked) return;
+ let timer: ReturnType | undefined;
+ const lockAfter = () => {
+ if (timer) clearTimeout(timer);
+ timer = setTimeout(handleLock, lockDelay * 60_000);
+ };
+ const visibility = () => {
+ if (document.hidden) {
+ if (lockMode === "immediate") handleLock();
+ else if (lockMode === "delay") lockAfter();
+ } else if (timer && lockMode === "delay") {
+ clearTimeout(timer);
+ }
+ };
+ const activity = () => {
+ if (lockMode === "idle") lockAfter();
+ };
+ document.addEventListener("visibilitychange", visibility);
+ if (lockMode === "idle") {
+ for (const event of ["pointerdown", "keydown", "scroll"] as const)
+ window.addEventListener(event, activity, { passive: true });
+ lockAfter();
+ }
+ return () => {
+ document.removeEventListener("visibilitychange", visibility);
+ for (const event of ["pointerdown", "keydown", "scroll"] as const)
+ window.removeEventListener(event, activity);
+ if (timer) clearTimeout(timer);
+ };
+ }, [handleLock, isUnlocked, lockDelay, lockMode]);
+
const handleViewerError = useCallback(() => {
setSessionMessage(
- "The full encrypted image could not be opened. Its preview remains available.",
+ "The full private image could not be opened. Its preview remains available.",
);
}, []);
const handleSessionExpired = useCallback(() => {
@@ -310,8 +398,8 @@ export function VaultGallery() {
Locked Vault
- Originals stay encrypted at rest. This session exists in memory
- only.
+ Photos remain in private storage behind this local lock. The
+ session token exists in memory only.
@@ -325,6 +413,120 @@ export function VaultGallery() {
+
+
+
+
+
+ Automatic lock
+
+ {(["immediate", "delay", "idle"] as const).map((mode) => (
+
+
+ ))}
+
+
+ Delay / idle timeout{" "}
+ {
+ const value = Number(event.target.value);
+ setLockDelay(value);
+ localStorage.setItem(
+ "find-vault-lock-delay",
+ String(value),
+ );
+ }}
+ className="ml-2 rounded-lg border border-[var(--frost)] bg-[color:var(--void)] px-2 py-1"
+ >
+ 1 minute
+ 5 minutes
+ 15 minutes
+ 30 minutes
+
+
+
+
+
+
+ New one-time recovery code
+
+
+ {newRecoveryCode}
+
+
+
{sessionMessage && (
{sessionMessage}
@@ -371,10 +573,7 @@ export function VaultGallery() {
restoreMutation.mutate(item.id)}
className="inline-flex items-center gap-1 rounded-full bg-black/65 px-3 py-1.5 text-xs font-medium text-white backdrop-blur transition hover:bg-black/85 disabled:cursor-wait disabled:opacity-60"
>
diff --git a/frontend/src/components/vault/VaultUnlock.tsx b/frontend/src/components/vault/VaultUnlock.tsx
index 22ef3129..663f52a3 100644
--- a/frontend/src/components/vault/VaultUnlock.tsx
+++ b/frontend/src/components/vault/VaultUnlock.tsx
@@ -1,93 +1,201 @@
"use client";
+import { useQuery } from "@tanstack/react-query";
import axios from "axios";
+import { KeyRound, LockKeyhole, ShieldCheck } from "lucide-react";
import { useState } from "react";
import { vaultStore } from "@/store/vaultStore";
-import { unlockVault } from "./vault-client";
+import {
+ getVaultStatus,
+ recoverVault,
+ setupVault,
+ unlockVault,
+} from "./vault-client";
export function VaultUnlock() {
- const [errorMessage, setErrorMessage] = useState(null);
- const [isSubmitting, setIsSubmitting] = useState(false);
+ const status = useQuery({
+ queryKey: ["vault-status"],
+ queryFn: getVaultStatus,
+ retry: false,
+ });
+ const [mode, setMode] = useState<"unlock" | "recover">("unlock");
+ const [error, setError] = useState(null);
+ const [busy, setBusy] = useState(false);
+ const [recovery, setRecovery] = useState<{
+ code: string;
+ token: string;
+ } | null>(null);
+ const initialized = status.data?.initialized ?? true;
- const handleSubmit = async (event: React.FormEvent) => {
+ const submit = async (event: React.FormEvent) => {
event.preventDefault();
-
- const form = event.currentTarget;
- const input = form.elements.namedItem("passphrase");
- if (!(input instanceof HTMLInputElement)) {
+ const data = new FormData(event.currentTarget);
+ const password = String(data.get("password") ?? "").trim();
+ const confirmation = String(data.get("confirmation") ?? "").trim();
+ const recoveryCode = String(data.get("recovery") ?? "").trim();
+ if (
+ !password ||
+ (!initialized && password !== confirmation) ||
+ (mode === "recover" && !recoveryCode)
+ ) {
+ setError(
+ !initialized && password !== confirmation
+ ? "Passwords do not match."
+ : "Complete all required fields.",
+ );
return;
}
-
- const passphrase = input.value.trim();
- if (!passphrase) {
- setErrorMessage("Enter a vault passphrase to continue.");
- input.focus();
- return;
- }
-
- setErrorMessage(null);
- setIsSubmitting(true);
-
+ setBusy(true);
+ setError(null);
try {
- const sessionToken = await unlockVault(passphrase);
- vaultStore.getState().unlock(sessionToken);
- } catch (error) {
- if (axios.isAxiosError(error) && error.response?.status === 401) {
- setErrorMessage("Incorrect vault passphrase.");
- } else if (axios.isAxiosError(error) && error.response?.status === 400) {
- const detail = error.response.data?.detail;
- setErrorMessage(
- typeof detail === "string"
- ? detail
- : "Use at least 8 characters for a new vault passphrase.",
- );
+ if (!initialized) {
+ const result = await setupVault(password);
+ setRecovery({
+ code: result.recovery_code,
+ token: result.session_token,
+ });
+ await status.refetch();
+ } else if (mode === "recover") {
+ const result = await recoverVault(recoveryCode, password);
+ setRecovery({
+ code: result.recovery_code,
+ token: result.session_token,
+ });
} else {
- setErrorMessage(
- "Vault could not be unlocked right now. Please try again.",
- );
+ vaultStore.getState().unlock(await unlockVault(password));
}
+ } catch (caught) {
+ const detail = axios.isAxiosError(caught)
+ ? caught.response?.data?.detail
+ : null;
+ setError(
+ typeof detail === "string"
+ ? detail
+ : "Vault could not be opened. Please try again.",
+ );
} finally {
- input.value = "";
- setIsSubmitting(false);
+ setBusy(false);
}
};
+ if (status.isPending)
+ return (
+
+ );
+
+ if (recovery) {
+ return (
+
+ Save your recovery code
+
+ This code is shown once. Keep it offline; Find stores only a one-way
+ hash.
+
+
+ {recovery.code}
+
+ vaultStore.getState().unlock(recovery.token)}
+ className="mt-5 rounded-full bg-[color:var(--near-white)] px-5 py-2.5 text-sm font-semibold text-[color:var(--void)]"
+ >
+ I saved the code
+
+
+ );
+ }
+
return (
);
}
diff --git a/frontend/src/components/vault/vault-client.ts b/frontend/src/components/vault/vault-client.ts
index c602b4f1..8201c3b4 100644
--- a/frontend/src/components/vault/vault-client.ts
+++ b/frontend/src/components/vault/vault-client.ts
@@ -23,6 +23,55 @@ export async function unlockVault(passphrase: string): Promise {
return response.data.session_token;
}
+export async function getVaultStatus(): Promise<{
+ initialized: boolean;
+ recovery_available: boolean;
+}> {
+ const response = await api.get<{
+ initialized: boolean;
+ recovery_available: boolean;
+ }>("/api/vault/status");
+ return response.data;
+}
+
+export async function setupVault(
+ passphrase: string,
+): Promise<{ session_token: string; recovery_code: string }> {
+ const response = await api.post<{
+ session_token: string;
+ recovery_code: string;
+ }>("/api/vault/setup", { passphrase });
+ return response.data;
+}
+
+export async function recoverVault(
+ recoveryCode: string,
+ newPassphrase: string,
+): Promise<{ session_token: string; recovery_code: string }> {
+ const response = await api.post<{
+ session_token: string;
+ recovery_code: string;
+ }>("/api/vault/recover", {
+ recovery_code: recoveryCode,
+ new_passphrase: newPassphrase,
+ });
+ return response.data;
+}
+
+export async function changeVaultPassword(
+ currentPassphrase: string,
+ newPassphrase: string,
+): Promise<{ session_token: string; recovery_code: string }> {
+ const response = await api.post<{
+ session_token: string;
+ recovery_code: string;
+ }>("/api/vault/password", {
+ current_passphrase: currentPassphrase,
+ new_passphrase: newPassphrase,
+ });
+ return response.data;
+}
+
export async function listVaultItems(
sessionToken: string,
): Promise {
From c74fed607893369262a802483c60906d227a3b6a Mon Sep 17 00:00:00 2001
From: Abhash Chakraborty
<80592559+Abhash-Chakraborty@users.noreply.github.com>
Date: Tue, 14 Jul 2026 13:57:40 +0530
Subject: [PATCH 11/21] feat: modernize shell settings and search
---
frontend/src/__tests__/app-shell.test.tsx | 8 +-
frontend/src/__tests__/search-page.test.tsx | 3 +
frontend/src/app/globals.css | 8 +-
frontend/src/app/search/page.tsx | 246 +++++++++++-------
frontend/src/app/settings/page.tsx | 27 +-
frontend/src/components/NavBar.tsx | 25 +-
frontend/src/components/app-shell.tsx | 175 ++++++++-----
.../src/components/appearance-settings.tsx | 62 +++++
.../src/components/map-privacy-settings.tsx | 6 +-
frontend/src/components/universal-search.tsx | 234 +++++++++++++++++
frontend/src/lib/theme.ts | 40 +++
11 files changed, 643 insertions(+), 191 deletions(-)
create mode 100644 frontend/src/components/appearance-settings.tsx
create mode 100644 frontend/src/components/universal-search.tsx
create mode 100644 frontend/src/lib/theme.ts
diff --git a/frontend/src/__tests__/app-shell.test.tsx b/frontend/src/__tests__/app-shell.test.tsx
index fe839b8a..39f7b3b4 100644
--- a/frontend/src/__tests__/app-shell.test.tsx
+++ b/frontend/src/__tests__/app-shell.test.tsx
@@ -76,7 +76,13 @@ describe("AppShell", () => {
"/account",
);
expect(
- screen.getByRole("button", { name: "Switch to dark mode" }),
+ screen.getByRole("textbox", { name: "Search everything" }),
+ ).toBeInTheDocument();
+ expect(
+ screen.queryByLabelText(/switch to .* mode/i),
+ ).not.toBeInTheDocument();
+ expect(
+ screen.getByRole("button", { name: "Collapse sidebar" }),
).toBeInTheDocument();
});
diff --git a/frontend/src/__tests__/search-page.test.tsx b/frontend/src/__tests__/search-page.test.tsx
index 149bd52e..5fa7bcb5 100644
--- a/frontend/src/__tests__/search-page.test.tsx
+++ b/frontend/src/__tests__/search-page.test.tsx
@@ -4,6 +4,7 @@ import type React from "react";
import { beforeEach, describe, expect, it, vi } from "vitest";
const apiMocks = vi.hoisted(() => ({
+ getGallery: vi.fn(),
searchImages: vi.fn(),
submitSearchRating: vi.fn(),
}));
@@ -14,6 +15,7 @@ vi.mock("next/image", () => ({
}));
vi.mock("@/lib/api", () => ({
+ getGallery: apiMocks.getGallery,
searchImages: apiMocks.searchImages,
submitSearchRating: apiMocks.submitSearchRating,
}));
@@ -84,6 +86,7 @@ function renderWithQueryClient() {
describe("Search page", () => {
beforeEach(() => {
+ apiMocks.getGallery.mockResolvedValue({ items: [], total: 0 });
apiMocks.searchImages.mockReset();
apiMocks.submitSearchRating.mockReset();
});
diff --git a/frontend/src/app/globals.css b/frontend/src/app/globals.css
index fe35b0f8..fc7d933a 100644
--- a/frontend/src/app/globals.css
+++ b/frontend/src/app/globals.css
@@ -44,7 +44,7 @@
--status-pending-text: #ffe08a;
--status-failed-border: rgba(255, 32, 71, 0.3);
--status-failed-text: #ff9bab;
- --nav-height: 64px;
+ --nav-height: 56px;
--sidebar-width: 256px;
}
html.light,
@@ -96,7 +96,7 @@
--status-failed-border: rgba(239, 68, 68, 0.35);
--status-failed-text: #991b1b;
- --nav-height: 64px;
+ --nav-height: 56px;
--sidebar-width: 256px;
}
@@ -149,7 +149,7 @@
--status-failed-border: rgba(255, 32, 71, 0.3);
--status-failed-text: #ff9bab;
- --nav-height: 64px;
+ --nav-height: 56px;
--sidebar-width: 256px;
}
@@ -186,7 +186,7 @@
overflow-y: auto;
overflow-x: hidden;
font-synthesis: none;
- text-rendering: optimizeLegibility;
+ text-rendering: optimizelegibility;
-webkit-font-smoothing: antialiased;
}
diff --git a/frontend/src/app/search/page.tsx b/frontend/src/app/search/page.tsx
index 802771a6..0718cb14 100644
--- a/frontend/src/app/search/page.tsx
+++ b/frontend/src/app/search/page.tsx
@@ -1,36 +1,41 @@
"use client";
-import { useMutation } from "@tanstack/react-query";
+import { useMutation, useQuery } from "@tanstack/react-query";
import {
ArrowRight,
ImageOff,
Loader2,
Search as SearchIcon,
} from "lucide-react";
-import { useEffect, useRef, useState } from "react";
+import Image from "next/image";
+import { useSearchParams } from "next/navigation";
+import { Suspense, useEffect, useState } from "react";
import { FeedbackRating } from "@/components/feedback-rating";
import { ImagePreviewModal } from "@/components/image-preview-modal";
-import { TimelineMediaView } from "@/components/timeline-media-view";
-import { type SearchResult, searchImages, submitSearchRating } from "@/lib/api";
+import {
+ getGallery,
+ type SearchResult,
+ searchImages,
+ submitSearchRating,
+} from "@/lib/api";
import { MINIO_URL_REFRESH_INTERVAL_MS, resolveMediaUrl } from "@/lib/media";
-const examples = [
- "sunset over mountains",
- "people smiling",
- "documents with text",
- "street photography at night",
-];
-
-export default function SearchPage() {
+function SearchPageContent() {
+ const searchParams = useSearchParams();
const [query, setQuery] = useState("");
const [activeQuery, setActiveQuery] = useState("");
const [allResults, setAllResults] = useState([]);
const [hasMore, setHasMore] = useState(false);
const [currentSkip, setCurrentSkip] = useState(0);
const [isLoadingMore, setIsLoadingMore] = useState(false);
- const clearedRef = useRef(false);
+ const [viewerIndex, setViewerIndex] = useState(null);
const LIMIT = 24;
+ const recentQuery = useQuery({
+ queryKey: ["search-recent-uploads"],
+ queryFn: () => getGallery({ limit: 24, sortOrder: "newest" }),
+ staleTime: 30_000,
+ });
const searchMutation = useMutation({
mutationFn: async (params: {
@@ -51,6 +56,14 @@ export default function SearchPage() {
},
});
+ useEffect(() => {
+ const initialQuery = searchParams?.get("q")?.trim();
+ if (!initialQuery || initialQuery === activeQuery) return;
+ setQuery(initialQuery);
+ setActiveQuery(initialQuery);
+ searchMutation.mutate({ searchQuery: initialQuery, limit: LIMIT, skip: 0 });
+ }, [activeQuery, searchParams, searchMutation.mutate]);
+
// Periodic refresh - update first page results without losing loaded pages
useEffect(() => {
if (!activeQuery) return;
@@ -71,7 +84,6 @@ export default function SearchPage() {
event.preventDefault();
const trimmedQuery = query.trim();
if (trimmedQuery) {
- clearedRef.current = false;
setAllResults([]);
setHasMore(false);
setCurrentSkip(0);
@@ -150,7 +162,6 @@ export default function SearchPage() {
{
- clearedRef.current = true;
setQuery("");
searchMutation.reset();
setActiveQuery("");
@@ -164,31 +175,6 @@ export default function SearchPage() {
)}
-
-
- {examples.map((example) => (
- {
- clearedRef.current = false;
- setQuery(example);
- setAllResults([]);
- setHasMore(false);
- setCurrentSkip(0);
- setActiveQuery(example);
- searchMutation.mutate({
- searchQuery: example,
- limit: LIMIT,
- skip: 0,
- });
- }}
- className="frost-button px-3 py-1.5 text-xs text-[color:var(--silver)]"
- >
- {example}
-
- ))}
-
{searchMutation.isPending && (
@@ -203,14 +189,50 @@ export default function SearchPage() {
-
-
- Start with a place, subject, color, text, or moment.
-
-
+
+
+
+ Recently uploaded
+
+
+ Your newest gallery photos, ready to search.
+
+
+
+ {recentQuery.data.items.map((item) => (
+
+
+ ))}
+
+ )}
{allResults.length === 0 && searchMutation.data && (
@@ -236,62 +258,76 @@ export default function SearchPage() {
- result.media_id}
- getDate={(result) => result.metadata.created_at}
- getWidth={(result) => result.metadata.width}
- getHeight={(result) => result.metadata.height}
- getThumbnailUrl={(result) =>
- resolveMediaUrl(
- result.metadata.thumbnail_url ?? result.metadata.url,
- result.metadata.minio_key,
- result.media_id,
- !result.metadata.thumbnail_url,
- )
- }
- getOriginalUrl={(result) =>
- `/api/image/${result.media_id}/original`
- }
- getAlt={(result) => result.metadata.filename}
- getOpenLabel={(result) => `Preview ${result.metadata.filename}`}
- renderItemActions={(result) => (
-
-
- {Math.round(result.similarity * 100)}%
-
-
- submitSearchRating(result.media_id, rating)
+
+ {allResults.map((result, index) => (
+
+
- )}
- renderViewer={({ items, index, onIndexChange, onClose }) => {
- const result = items[index];
- if (!result) return null;
- return (
-
onIndexChange(index - 1)}
- onNext={() => onIndexChange(index + 1)}
- hasPrevious={index > 0}
- hasNext={index < items.length - 1}
- onDeleted={(mediaId) => {
- setAllResults((current) =>
- current.filter((item) => item.media_id !== mediaId),
- );
- onClose();
- }}
+ setViewerIndex(index)}
+ className="absolute inset-0 z-10 outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-[color:var(--blue)]"
/>
- );
- }}
- />
+
+
+ {Math.round(result.similarity * 100)}%
+
+
+
+ submitSearchRating(result.media_id, rating)
+ }
+ />
+
+
+ setViewerIndex(null)}
+ onPrevious={() =>
+ setViewerIndex((current) =>
+ current === null ? null : current - 1,
+ )
+ }
+ onNext={() =>
+ setViewerIndex((current) =>
+ current === null ? null : current + 1,
+ )
+ }
+ hasPrevious={viewerIndex > 0}
+ hasNext={viewerIndex < allResults.length - 1}
+ onDeleted={(mediaId) => {
+ setAllResults((current) =>
+ current.filter((item) => item.media_id !== mediaId),
+ );
+ setViewerIndex(null);
+ }}
+ />
+ )}
{hasMore && (
@@ -318,3 +354,11 @@ export default function SearchPage() {
);
}
+
+export default function SearchPage() {
+ return (
+
- - ) : ( - // biome-ignore lint/a11y/useAltText: shared tile (view-only) -
)}
/>
+ + {!isLoading && !isError && ( +