PRODUCT_LISTINGS_GENIE

# ProductListingsGenie: DIY Installation Manual

ProductListingsGenie is a self-install local listing workflow. It turns product photos and rough notes into editable listing drafts and copy-ready export packs. The seller reviews and approves every listing before export.

This is not a hosted Aldermere Systems service. It does not scrape marketplaces or publish listings automatically.

---

## Prerequisites & Accounts Needed
1. **Windows PC:** Normal user account able to extract a ZIP file and run a batch file.
2. **Python 3:** Installed locally and available from Windows command line.
3. **Web browser:** Chrome, Edge, Firefox, or similar. App opens at `http://127.0.0.1:8781`.
4. **OpenAI API key:** Required only for OpenAI-assisted listing drafts.
5. **OpenAI access:** Works with the buyer's own valid OpenAI API key, subject to their OpenAI account access, billing, model availability, and usage limits.
6. **Listing inputs:** Product photos where available, rough notes, condition, category, and intended platform profile.

No OpenAI API key is supplied by Aldermere Systems.

---

## What Is Included
1. **ProductListingsGenie local app:** Python standard-library browser app.
2. **run_product_listings_genie.bat:** Windows launcher.
3. **setup_guide:** Buyer quick-start and installation instructions.
4. **promo_pack:** Product listing copy and customer-facing summary.
5. **Local export workflow:** Title, description, tags, pricing notes, photo checklist, and listing-pack JSON files.

The package does not include a hosted backend, marketplace scraping, auto-publishing, a supplied API key, logs, test databases, or admin files.

---

## Step 1: Extract the Package
1. Download `product-listings-genie.zip`.
2. Right-click the ZIP and select **Extract All**.
3. Move extracted folder somewhere sensible, for example `Documents\ProductListingsGenie`.
4. Do not run the app from inside the compressed ZIP preview.

## Step 2: Confirm Python Is Available
1. Open Command Prompt.
2. Run `python --version`.
3. Continue if Windows shows Python 3.
4. If missing, install Python 3 from the official Python website or Microsoft Store, then repeat the check.

## Step 3: Start ProductListingsGenie
1. Open the extracted folder.
2. Double-click `run_product_listings_genie.bat`.
3. A local server starts on your computer.
4. Open `http://127.0.0.1:8781` if the browser does not open automatically.

## Step 4: Create a Listing Draft
1. Choose Etsy, eBay, Shopify, or General profile.
2. Add rough product notes and condition details.
3. Add product photos when useful.
4. Paste your own OpenAI API key only when using OpenAI-assisted draft generation.
5. Generate a draft, then edit the title, description, tags, pricing notes, and photo checklist.

If OpenAI-assisted drafting is unavailable, use the local text-only draft path. The buyer remains responsible for listing facts, condition, price, and platform rules.

## Step 5: Review, Approve, and Export
1. Confirm all claims, measurements, condition notes, tags, and price guidance.
2. Tick seller approval only when the draft is ready.
3. Export the listing pack.
4. Copy the approved content into the target marketplace manually.

The approval point is intentional: notes and photos -> draft -> seller review -> approved pack -> manual marketplace use.

## Test Before Real Use
1. Create one fake listing.
2. Generate a text-only draft.
3. Optional: test OpenAI-assisted drafting with your own key.
4. Edit and approve the draft.
5. Export the pack and check it contains no API key.

## Privacy & Security Notes
1. ProductListingsGenie runs on `127.0.0.1`, local computer only.
2. No Aldermere Systems backend, telemetry, or remote customer database exists.
3. API keys are not saved in app data, exports, ZIP, or logs.
4. If OpenAI-assisted drafting is used, the current request content is sent directly to OpenAI.
5. Do not paste API keys into screenshots, emails, public documents, or support messages.

## Uninstall / Rollback
1. Close browser tab and launcher window.
2. Delete extracted ProductListingsGenie folder.
3. Delete exported listing packs no longer needed.

ProductListingsGenie does not install a Windows service, browser extension, marketplace integration, or Aldermere background agent.