luci-upload

luci-upload

Upload a video or image file to memories.ai with capture time and location metadata. User can also download LUCI AI app to manually upload as well.

Setup

Requires MEMORIES_AI_KEY — same key as luci-memory. If not found, create {baseDir}/.env:

MEMORIES_AI_KEY=sk-your-key-here

Also requires ffprobe (from ffmpeg) for auto-extracting video metadata. Images can be uploaded without ffprobe finding anything — in that case the agent must supply time and location explicitly.

When to use

How it works

The script tries to auto-extract capture time and GPS coordinates from the file metadata (via ffprobe). Videos from phones and JPEGs with EXIF usually work; PNGs and screenshots rarely have this info. If metadata is missing, the agent should ask the user for:

1. When was it taken? → pass as --datetime with --timezone 2. Where was it taken? → pass as --location (geocoded automatically) or --lat/--lon

The multipart Content-Type is chosen by file extension (.mp4 → video/mp4, .png → image/png, .jpg → image/jpeg, etc.).

How to invoke

# Probe metadata only (no upload) — do this first to check what info is available
bash {baseDir}/run.sh --probe --file /path/to/file
Upload a video with auto-detected metadata
bash {baseDir}/run.sh --file /path/to/video.mp4
Upload a video with explicit time and location name (geocoded to lat/lon)
bash {baseDir}/run.sh --file /path/to/video.mp4 --datetime "2025-06-22 14:00:00" --timezone Asia/Shanghai --location "Suzhou, China"
Upload an image — usually needs explicit time/location since EXIF is often missing
bash {baseDir}/run.sh --file /path/to/photo.png --datetime "2025-09-01 00:00:00" --timezone Asia/Shanghai --location "Shunde, China"
Upload with explicit coordinates and epoch timestamp
bash {baseDir}/run.sh --file /path/to/video.mp4 --time 1769097600000 --lat 31.3 --lon 120.59

Parameters

| Flag | Short | Description | |------|-------|-------------| | --file | -f | Path to video or image file (required) | | --probe | | Only show extracted metadata, don't upload | | --time | | Start time as epoch milliseconds | | --datetime | | Start time as readable datetime (e.g. 2025-06-22 14:00:00) | | --timezone | | Timezone for --datetime (e.g. Asia/Shanghai, UTC, +8) | | --lat | | Latitude | | --lon | | Longitude | | --location | | Location name to geocode (e.g. Suzhou, China) |

Workflow

1. Probe first: run with --probe to see what metadata the file has 2. If time and GPS are both present → upload directly 3. If missing (common for images, screenshots), ask the user for the missing info (time and/or location) 4. Upload with all parameters filled in

Requires MEMORIES_AI_KEY — same key as luci-memory. If not found, create {baseDir}/.env:

MEMORIES_AI_KEY=sk-your-key-here

Also requires ffprobe (from ffmpeg) for auto-extracting video metadata. Images can be uploaded without ffprobe finding anything — in that case the agent must supply time and location explicitly.