Spark
Spark is an autonomous marketing copilot that helps Shopify merchants detect store opportunities and run multi-channel campaigns.
Core trick
Parallel agents monitor Shopify inventory and sales, then draft copy and images that a merchant approves before publishing.
Description
Spark is an autonomous marketing copilot that helps Shopify merchants detect store opportunities and run multi-channel campaigns. It continuously monitors inventory, sales trends, and cultural/festival calendars to proactively draft targeted promotions. By delegating tasks across managed agents, it co-generates copy, high-fidelity images, and videos in parallel using Gemini models. Merchants maintain full control through a "human-in-the-loop" dashboard to conversationally revise and approve every draft. It solves the resource-constraint, fragmentation, and speed issues that prevent local SMBs from running professional cross-channel ads.
README excerpt
# Spark Spark is an autonomous marketing copilot for Shopify merchants. It detects a store opportunity, delegates work across managed agents, generates channel-specific creatives in parallel, accepts conversational revisions per artifact, and keeps every external action behind explicit merchant approval. The hackathon build targets: - Problem Statement 2: observable orchestration with the Gemini Interactions API and the Antigravity managed agent. - Problem Statement 3: high-throughput 1K ad generation with `gemini-3.1-flash-lite-image`. - Optional enhancement: animate the selected still with `gemini-omni-flash-preview`. ## Run locally Requirements: Node.js 20+, a Gemini API key, a Composio project, and a linked Supabase project. ```bash npm install cp .env.example .env.local npm run dev ``` Open `http://localhost:3000`, sign in, and connect the live Shopify account before analysis. Spark does not ship simulated store or performance data. ## Environment | Variable | Purpose | | --- | --- | | `GEMINI_API_KEY` | Managed-agent, copy, NB2 Lite, and Omni requests | | `COMPOSIO_API_KEY` | Merchant-scoped Composio sessions for Shopify, Instagram, and Google Ads | | `NEXT_PUBLIC_APP_URL` | Public HTTPS origin used for OAuth callbacks and Instagram-accessible JPEGs | | `SUPABASE_URL` | Supabase project URL used by server-side auth | | `SUPABASE_PUBLISHABLE_KEY` | Publishable key used with row-level security | | `SUPABASE_SECRET_KEY` | Server-only key reserved for trusted admin