🛒 Launch Kit

Commerce-first workspace for products, offers, creative angles, listings, Shopify actions, and launch assets.

Domain: Startup / GTM · Suite: E-commerce Growth Suite · Accent: #a3e635

🚀 Quick Start · ✨ Features · 🎛️ Customization · 🧠 LLM Providers · 🧪 Testing · 🧯 Troubleshooting

🧭 What This Project Does

Launch Kit is a standalone, browser-based AI workflow app for Startup / GTM. It turns structured inputs, uploaded files, and project-specific settings into reviewable outputs using a deterministic local engine plus optional local/cloud LLM enhancement.

Core job: Idea/product → launch assets.

Designed for: Domain operator, business owner, analyst, or team member who needs this workflow executed reliably.

Why use it:

🧩 Standalone project folder: run this project by itself without depending on a central dashboard.
🖥️ Elegant GUI: includes project-specific panels, structured forms, upload handling, output preview, and exports.
🧠 Model-flexible: choose local models for privacy or cloud models for stronger reasoning.
🧾 Auditable: every run is stored in SQLite with inputs, settings, result, and export history.
🚫 No fake live data: external systems are only used when real API keys/connectors are configured.
🛡️ Human review gates: sensitive legal, medical, hiring, finance, or security outputs are flagged for review.

✨ Features

ICP definition
positioning
landing page copy
email/social launch plan
offer stack
KPI plan
launch calendar
asset checklist

🧱 Built-In Platform Capabilities

⚡ FastAPI backend with documented JSON endpoints.
🎨 Responsive web UI with dark, polished SaaS-style layout.
📁 File upload and text extraction for common document/code formats.
🗂️ Job history saved locally in data/*.sqlite3.
🔐 Encrypted provider settings for API keys and local endpoints.
📤 Exports to Markdown, JSON, DOCX, and PDF when dependencies are available.
🔌 Provider routing for local and cloud LLMs.
🧪 Local test file to verify the project runs.

🎨 UX/UI Design

UX profile: Growth Command Center

Workflow layout: Research → positioning → content/ads → launch queue → measurement

Empty state: Enter a product, offer, audience, or store task. External Shopify/marketplace actions require real credentials.

Main UI Components

Product/offer canvas
Margin and pricing cards
Platform preview board
Creative variant matrix
Launch checklist

Review / Workflow Lanes

Research
Position
Create
Approve
Launch

Metrics Shown in the Interface

Offer strength
Margin readiness
Channel fit
Launch completeness

Quick Actions

Build offer matrix
Generate channel previews
Check claims/compliance
Create launch queue

🧩 Project Inputs

These are the main fields exposed by the GUI and /api/run. Required fields are enforced before execution.

Field	Type	Required	Default	Purpose
`idea` Idea	text	Yes	—	Affects input: Idea.
`product` product	text	Yes	—	Affects input: product.
`work_brief` Work brief / source text / URL / instructions	textarea	Yes	—	Paste the material, URL, description, or instruction needed for this project.

🎛️ Customization

This project is not a generic prompt box. The customization controls are connected to workflow behavior, validation, output shape, and export format.

Field	Type	Required	Default	Purpose
`execution_mode` Execution mode	select	No	Production	Controls strictness, depth, and output format for this project workflow.
`product_type` product type	text	No	—	Affects customization: product type.
`market` market	text	No	—	Affects customization: market.
`price` price	text	No	—	Affects customization: price.
`channel` channel	text	No	—	Affects customization: channel.
`launch_date` launch date	text	No	—	Affects customization: launch date.
`brand_voice` brand voice	text	No	—	Affects customization: brand voice.
`budget` budget	text	No	—	Affects customization: budget.
`audience_sophistication` audience sophistication	select	No	general	Affects customization: audience sophistication.
`output_format` output format	select	No	Markdown	Affects customization: output format.
`language` language	select	No	English	Affects customization: language.
`privacy_mode` privacy mode	select	No	cloud allowed	Affects customization: privacy mode.
`confidence_threshold` Confidence threshold	slider	No	75	Items below this confidence are escalated to the human review queue.

Select / Option Controls

Execution mode: Draft, Production, Audit / strict review, JSON/API output
audience sophistication: general, executive, technical, legal, medical, student, customer
output format: Markdown, JSON, CSV, PDF, DOCX, XLSX
language: English, Arabic, Egyptian Arabic, French, German, Spanish
privacy mode: cloud allowed, local only, redact sensitive data

🧠 LLM Providers

You can run the project with the local deterministic engine, or enhance the output with a configured LLM provider.

Supported Provider Types

Provider Type	Examples	Best For
Local OpenAI-compatible	Ollama, LM Studio, vLLM	Private files, offline/local workflows, cost control
Cloud OpenAI-compatible	OpenAI, OpenRouter, custom gateway	General high-quality generation and structured output
Anthropic	Claude models	Long-context reasoning and document-heavy workflows
Google Gemini	Gemini models	Multimodal or Google ecosystem workflows
Mistral	Mistral API	Fast European cloud models
Azure OpenAI	Azure deployments	Enterprise-controlled cloud deployment
AWS Bedrock	Bedrock-hosted models	AWS enterprise environments

Recommended Model Usage

Use Case	Recommendation
Drafting	fast cloud or local instruct model
Reasoning	strong reasoning model
Private documents	local model via Ollama/LM Studio/vLLM
Vision/PDF pages	vision-capable model when image pages are used

🚀 Quick Start

1) Clone or open this folder

cd launch-kit

2) Run on macOS / Linux / WSL

chmod +x run_gui.sh
./run_gui.sh

3) Run on Windows PowerShell

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\run_gui_windows.ps1

4) Open the GUI

http://127.0.0.1:9130

🛠️ Manual Installation

Use this when you want full control instead of the run scripts.

cd launch-kit
python -m venv .venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate
python -m pip install --upgrade pip
pip install -r requirements.txt
cp .env.example .env           # Windows: copy .env.example .env
uvicorn app.main:app --host 127.0.0.1 --port 9130

🔐 Environment Variables

The project can be configured through the GUI settings screen or .env/environment variables.

Variable	Purpose
`AI_SUITE_HOST`	Host to bind the local app, usually `127.0.0.1`.
`AI_SUITE_PORT`	Port for this project GUI, default `9130`.
`AI_SUITE_DB`	SQLite database path for job history.
`AI_SUITE_SECRET_KEY`	Secret used for local encryption/signing. Set this in production.
`OPENAI_API_KEY`	Enables OpenAI-compatible cloud calls.
`ANTHROPIC_API_KEY`	Enables Anthropic/Claude calls.
`GEMINI_API_KEY`	Enables Google Gemini calls.
`OPENROUTER_API_KEY`	Enables OpenRouter model routing.
`MISTRAL_API_KEY`	Enables Mistral cloud models.
`AZURE_OPENAI_ENDPOINT`	Azure OpenAI endpoint URL.
`AZURE_OPENAI_API_KEY`	Azure OpenAI key.
`AZURE_OPENAI_DEPLOYMENT`	Azure deployment name.
`OLLAMA_BASE_URL`	Local Ollama OpenAI-compatible base URL.
`LMSTUDIO_BASE_URL`	Local LM Studio OpenAI-compatible base URL.
`VLLM_BASE_URL`	Local vLLM OpenAI-compatible base URL.

🖥️ How to Use the GUI

Open the local URL.
Review the project purpose and workflow lanes.
Fill the required input fields.
Adjust only the project-related customization controls.
Upload source files when needed.
Choose Rule Engine for local deterministic output or select a configured LLM provider.
Run the workflow.
Review warnings, scorecards, and output sections.
Export the result as Markdown, JSON, DOCX, or PDF.

🔄 Workflow

Idea/product
launch assets

Analysis Modules

launch_assets
marketing_variants
roadmap_builder

Output Sections

Launch plan
Messaging
Channels
Assets

Scorecards

Input completeness
Domain fit
Risk level
Automation readiness
Export readiness

📤 Outputs & Exports

launch plan
landing copy
emails
social pack
KPI dashboard

The export system is designed for reviewable deliverables. For regulated or business-critical work, export drafts should be reviewed before sending to clients, customers, patients, employees, authorities, or production systems.

🔌 Real Integrations & Connector Policy

Configured integrations in this standalone folder:

File upload
REST API
Export download
Job history

Real Connector Requirements

approved legal playbook or clause library
jurisdiction-specific review by qualified counsel
document management/e-sign connector if exporting final agreements
brand voice guide
ad platform or analytics connector for live performance data
claims/compliance review before publishing

Important: this project does not simulate live data. If a workflow needs live Shopify, ATS, ERP, tax, customs, medical, security, market, map, analytics, or repository data, it must be connected with valid credentials and real API access. Missing connectors should produce clear setup errors rather than invented results.

🧯 Guardrails

Show uncertainty and confidence
Cite evidence from input when possible
Human review required for legal, medical, financial, hiring, or security decisions
Do not invent facts absent from input

Recommended operating rules:

✅ Use local models for private or sensitive files.
✅ Keep API keys out of Git.
✅ Review low-confidence or high-impact outputs manually.
✅ Keep source files and exported deliverables organized under data/.
❌ Do not treat AI output as legal, medical, tax, hiring, trading, or security authority without expert review.

🧪 Testing

Run the local smoke test:

python tests/test_single_project.py

Run a health check after starting the server:

curl http://127.0.0.1:9130/api/health

Expected result: the API returns ok: true and identifies this project.

🧬 API Usage

Method	Endpoint	Use
`GET`	`/`	Opens the browser GUI.
`GET`	`/api/health`	Health check for deployment and uptime monitoring.
`GET`	`/api/projects`	Returns the local project configuration.
`GET`	`/api/projects/{slug}`	Returns the project plugin metadata.
`GET`	`/api/providers`	Lists configured providers and local/cloud options.
`POST`	`/api/providers`	Saves provider settings/API keys.
`POST`	`/api/upload`	Uploads source files for extraction or context.
`POST`	`/api/run`	Runs the project workflow.
`GET`	`/api/jobs`	Lists previous runs and job history.
`GET`	`/api/jobs/{job_id}`	Reads one completed job.
`GET`	`/api/jobs/{job_id}/export/{fmt}`	Exports a job as `md`, `json`, `docx`, or `pdf`.
`GET`	`/api/project-local-status`	Verifies local project registration and implementation status.

Minimal Run Request

curl -X POST http://127.0.0.1:9130/api/run \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "work_brief": "Paste the source material or task details here"
    },
    "customization": {
      "execution_mode": "Production"
    },
    "provider": "rule_engine"
  }'

📁 Folder Structure

launch-kit/
├─ app/                         # FastAPI backend, schemas, DB, providers, exports
├─ static/                      # Browser GUI assets
├─ plugins/                     # Project plugin JSON metadata
├─ data/                        # SQLite DB, uploads, exports
├─ tests/                       # Smoke tests
├─ project_config.json          # Project-specific inputs, controls, UX, workflow
├─ PROJECT_IMPLEMENTATION.md    # Implementation details and domain notes
├─ requirements.txt             # Python dependencies
├─ run_gui.sh                   # macOS/Linux/WSL launcher
├─ run_gui_windows.ps1          # Windows PowerShell launcher
└─ README.md                    # This file

🚢 Deployment Notes

For local/private deployment, run with uvicorn behind a reverse proxy if needed. For production:

Set AI_SUITE_SECRET_KEY.
Use HTTPS.
Store provider keys in environment variables or a proper secret manager.
Restrict upload sizes and allowed file types.
Back up the SQLite database or move job storage to a managed database.
Add authentication before exposing beyond localhost.
Enable logging and monitoring.

Example production-style command:

AI_SUITE_HOST=0.0.0.0 AI_SUITE_PORT=9130 uvicorn app.main:app --host 0.0.0.0 --port 9130

🧯 Troubleshooting

Problem	Fix
`python` not found	Install Python 3.10+ and ensure it is on PATH.
PowerShell blocks the script	Run `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass`.
Port already in use	Set another port: `AI_SUITE_PORT=9200 ./run_gui.sh`.
Provider fails	Verify API key, base URL, selected model, and account quota.
Local model fails	Start Ollama/LM Studio/vLLM before running the workflow.
PDF/DOCX export fails	Reinstall requirements and confirm optional export dependencies installed.
Upload extraction is incomplete	Use cleaner source files or paste the important text into `work_brief`.

🧭 Extension Points

You can extend this project by editing:

project_config.json for inputs, settings, output sections, UX metadata, and workflow labels.
plugins/launch-kit.json for plugin metadata.
app/domain_engine.py for deterministic business logic.
app/llm_gateway.py for provider integrations.
static/app.js and static/styles.css for GUI behavior and component design.
tests/test_single_project.py for stronger project-specific tests.

✅ Final Implementation Status

Area	Status
Standalone folder GUI	✅ Implemented
FastAPI backend	✅ Implemented
Project-specific config	✅ Implemented
Local deterministic workflow	✅ Implemented
Local/cloud LLM routing	✅ Implemented
Uploads and exports	✅ Implemented
Job history	✅ Implemented
Real external connectors	⚠️ Requires valid credentials/API setup
Fake/simulated live data	❌ Not allowed

📜 License

Use the license included in this folder. If no explicit license is present, treat the code as private until you choose one.

Name		Name	Last commit message	Last commit date
Latest commit History 68 Commits
app		app
plugins		plugins
src/launch_kit		src/launch_kit
static		static
tests		tests
.env.example		.env.example
LICENSE		LICENSE
PROJECT_IMPLEMENTATION.md		PROJECT_IMPLEMENTATION.md
README.md		README.md
project_config.json		project_config.json
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
run_gui.sh		run_gui.sh
run_gui_windows.ps1		run_gui_windows.ps1

Folders and files

Latest commit

History

Repository files navigation

🛒 Launch Kit

Commerce-first workspace for products, offers, creative angles, listings, Shopify actions, and launch assets.

🧭 What This Project Does

✨ Features

🧱 Built-In Platform Capabilities

🎨 UX/UI Design

Main UI Components

Review / Workflow Lanes

Metrics Shown in the Interface

Quick Actions

🧩 Project Inputs

🎛️ Customization

Select / Option Controls

🧠 LLM Providers

Supported Provider Types

Recommended Model Usage

🚀 Quick Start

1) Clone or open this folder

2) Run on macOS / Linux / WSL

3) Run on Windows PowerShell

4) Open the GUI

🛠️ Manual Installation

🔐 Environment Variables

🖥️ How to Use the GUI

🔄 Workflow

Analysis Modules

Output Sections

Scorecards

📤 Outputs & Exports

🔌 Real Integrations & Connector Policy

Real Connector Requirements

🧯 Guardrails

🧪 Testing

🧬 API Usage

Minimal Run Request

📁 Folder Structure

🚢 Deployment Notes

🧯 Troubleshooting

🧭 Extension Points

✅ Final Implementation Status

📜 License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages