Skip to content
Back to search

lumenpitch

SkillWorks with Claude CodeGitHub

AI-Powered Presentation Studio & Slide Generation Engine — Local & Cloud LLMs (Ollama, OpenAI, Claude, Gemini), React/Tailwind Template V2 Engine, Vision PPTX Import & Native PPTX/PDF Export.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/annoris--lumenpitch/badge.svg)](/listings/annoris--lumenpitch)

HTML

<a href="/listings/annoris--lumenpitch"><img src="/api/listings/annoris--lumenpitch/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

> [!IMPORTANT] > **Solana-Gated Sponsorware Architecture (`annoris/lumenpitch-pro-source`):** > - **Interactive Live Web & Mobile App Studio:** Explore the studio UI right now at **[https://annoris.github.io/lumenpitch/](https://annoris.github.io/lumenpitch/)** > - **Full Editable Full-Stack Source Vault (`annoris/lumenpitch-pro-source`):** The complete, unminified full-stack platform (`servers/nextjs/`, `servers/fastapi/`, `electron/`, `templates/`, `scripts/`, `Dockerfile`, and `docker-compose.yml`) is hosted inside the private repository **`annoris/lumenpitch-pro-source`**. > - **How to Unlock Full Clone & Download Access:** > 1. Send your contribution in **SOL** or **USDC-SPL** (**$75 – $149 USD** Individual Unlock / **$450 USD** Studio License / **$1,500 USD** Enterprise License) on Solana Mainnet to **`3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm`**. > 2. Submit your transaction signature (`txSig`) in a **[🔓 Solana Source Code Unlock Request](https://github.com/annoris/lumenpitch/issues/new?template=source_unlock_request.md)** (or [Release Access Claim Issue](https://github.com/annoris/lumenpitch/issues/new?template=claim-release-access.yml)). > 3. Your GitHub account will receive a collaborator invitation to **`https://github.com/annoris/lumenpitch-pro-source`**. See [`SOURCE_ACCESS.md`](./SOURCE_ACCESS.md) and [`PAYMENT.md`](./PAYMENT.md).

Prerequisites (Once Your GitHub Account Is Verified & Invited)

- **Node.js** `22.12+` & **npm** - **Python** `3.11` & **[uv](https://github.com/astral-sh/uv)** (fast Python package & lockfile manager)

Option 1: Local Multi-Process Development (For Verified Contributors)

1. **Clone the private source vault (`annoris/lumenpitch-pro-source`) and initialize your environment file:**

   git clone https://github.com/annoris/lumenpitch-pro-source.git
   cd lumenpitch-pro-source
   cp .env.example .env

2. **Install root dependencies and run the read-only project diagnostics check:**

   npm ci
   npm run doctor

3. **Start the FastAPI backend engine (`port 8000`):**

   cd servers/fastapi
   uv sync --locked --dev
   uv run python server.py --port 8000

4. **In a second terminal, start the Next.js studio interface (`port 3000`):**

   cd servers/nextjs
   npm ci
   npm run dev

5. **Open [http://localhost:3000](http://localhost:3000)** in your browser, create your local administrator account, and configure your preferred AI provider (or browse the workspace and 16 templates immediately).

---

Option 2: Docker Compose Deployment

LumenPitch includes production and development profiles in `docker-compose.yml` ([Private Source Vault](./SOURCE_ACCESS.md), with optional NVIDIA GPU passthrough via `production-gpu` and `development-gpu`).

# 1. Configure your environment variables in .env
cp .env.example .env

# 2. Launch the production service on http://localhost:5001
docker compose up --build production

> [!IMPORTANT] > **Export Engine Contract (`@lumenpitch/export-core`):** > Exports and conversions require a compatible external export archive authorized by the operator. No proprietary export binary is bundled or downloaded from an unverified third party by default. > - For local builds, synchronize an authorized `.tgz` archive: > ```bash > EXPORT_CORE_ARCHIVE=/authorized/path/export-core.tgz npm run sync:presentation-export > npm run check:presentation-export > ``` > - For Docker builds, set `EXPORT_CORE_DOWNLOAD_BASE` to an authorized release server you control, or provide the archive via a BuildKit secret.

---

Environment Configuration Reference (`.env`)

All runtime storage paths (`APP_DATA_DIRECTORY`, `TEMP_DIRECTORY`, `USER_CONFIG_PATH`, and `DATABASE_URL`) are kept outside the Git working tree:

# Core Paths & Persistence
APP_DATA_DIRECTORY=/tmp/lumenpitch-data
TEMP_DIRECTORY=/tmp/lumenpitch-temp
USER_CONFIG_PATH=/tmp/lumenpitch-data/userConfig.json

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 670 lines
  1. <div align="center">
  2. <img src="docs/images/lumenpitch-logo.svg" width="88" height="88" alt="LumenPitch Logo" />
  3. <h1>LumenPitch</h1>
  4. <h3><b>The Open-Source AI Presentation Studio &amp; Multi-LLM Deck Engine</b></h3>
  5. <p><i>From raw ideas, documents, and web research to executive-grade slide decks — powered by your choice of Local AI or Cloud LLMs.</i></p>
  6. <p>
  7. <a href="https://annoris.github.io/lumenpitch/"><img src="https://img.shields.io/badge/LIVE_STUDIO-annoris.github.io%2Flumenpitch-c6f46a?style=for-the-badge&amp;logo=githubpages&amp;logoColor=103d38&amp;labelColor=103d38" alt="Live Interactive Studio" /></a>
  8. <a href="https://github.com/annoris/lumenpitch/stargazers"><img src="https://img.shields.io/github/stars/annoris/lumenpitch?style=for-the-badge&amp;logo=github&amp;color=103d38&amp;labelColor=0a2925" alt="GitHub Stars" /></a>
  9. <a href="SOURCE_ACCESS.md"><img src="https://img.shields.io/badge/Source_Vault-Solana_Unlock-14F195?style=for-the-badge&amp;logo=solana&amp;logoColor=black" alt="Solana Source Unlock" /></a>
  10. <a href="SOURCE_ACCESS.md"><img src="https://img.shields.io/badge/Next.js_16-black?style=for-the-badge&amp;logo=next.js&amp;logoColor=white" alt="Next.js 16" /></a>
  11. <a href="SOURCE_ACCESS.md"><img src="https://img.shields.io/badge/FastAPI-009688?style=for-the-badge&amp;logo=fastapi&amp;logoColor=white" alt="FastAPI" /></a>
  12. <a href="SOURCE_ACCESS.md"><img src="https://img.shields.io/badge/Python_3.11-3776AB?style=for-the-badge&amp;logo=python&amp;logoColor=white" alt="Python 3.11" /></a>
  13. <a href="SOURCE_ACCESS.md"><img src="https://img.shields.io/badge/Electron-191970?style=for-the-badge&amp;logo=Electron&amp;logoColor=white" alt="Electron" /></a>
  14. <a href="#supported-ai-providers--ecosystem"><img src="https://img.shields.io/badge/AI-Ollama_%7C_OpenAI_%7C_Claude_%7C_Gemini-6E56CF?style=for-the-badge" alt="Multi-LLM &amp; Local AI" /></a>
  15. <a href="PAYMENT.md"><img src="https://img.shields.io/badge/Solana_Pay-3HvUMC...zvBdm-14F195?style=for-the-badge&amp;logo=solana&amp;logoColor=black" alt="Solana Pay" /></a>
  16. <a href="LICENSE"><img src="https://img.shields.io/badge/License-Solana_Sponsorware-103d38?style=for-the-badge&amp;logoColor=c6f46a" alt="License" /></a>
  17. </p>
  18. <p align="center">
  19. <a href="https://annoris.github.io/lumenpitch/"><b>🚀 Launch Live Interactive Studio</b></a> •
  20. <a href="SOURCE_ACCESS.md"><b>🔓 Unlock Full Source Vault (<code>annoris/lumenpitch-pro-source</code>)</b></a> •
  21. <a href="#why-lumenpitch">Why LumenPitch?</a> •
  22. <a href="#visual-showcase--platform-tour">Visual Tour</a> •
  23. <a href="#16-bundled-studio-templates-gallery">16 Templates</a> •
  24. <a href="#architecture--tech-stack">Architecture</a> •
  25. <a href="#support--crypto-sponsorship-solana">Solana Support</a>
  26. </p>
  27. <hr />
  28. <p align="center">
  29. <a href="https://annoris.github.io/lumenpitch/">
  30. <img src="https://img.shields.io/badge/%F0%9F%9A%80_CLICK_HERE_TO_LAUNCH_LIVE_INTERACTIVE_STUDIO-annoris.github.io%2Flumenpitch-c6f46a?style=for-the-badge&amp;logo=githubpages&amp;logoColor=103d38&amp;labelColor=103d38" alt="Launch Live Interactive Studio" height="44" />
  31. </a>
  32. </p>
  33. <a href="https://annoris.github.io/lumenpitch/">
  34. <img src="docs/images/dashboard.png" alt="LumenPitch Studio Workspace — Click to Launch Live Studio" width="100%" />
  35. </a>
  36. <br />
  37. <table>
  38. <tr>
  39. <td align="center" width="33%">
  40. <a href="https://annoris.github.io/lumenpitch/">
  41. <img src="docs/images/dashboard.png" alt="1. Creative Studio Workspace" width="100%" />
  42. </a>
  43. <br />
  44. <b>1. Creative Studio Workspace</b><br />
  45. <sub>PDF/DOCX/PPTX ingestion, live web grounding &amp; instant deck library</sub>
  46. </td>
  47. <td align="center" width="33%">
  48. <a href="https://annoris.github.io/lumenpitch/">
  49. <img src="docs/images/templates.png" alt="2. 16 Studio Design Systems (400+ Layouts)" width="100%" />
  50. </a>
  51. <br />
  52. <b>2. 16 Studio Design Systems (400+ Layouts)</b><br />
  53. <sub>Built-in certified themes + Custom <code>.pptx</code> Vision V2 Compiler</sub>
  54. </td>
  55. <td align="center" width="33%">
  56. <a href="https://annoris.github.io/lumenpitch/">
  57. <img src="docs/images/setup.png" alt="3. 4-Step AI Provider Setup Wizard" width="100%" />
  58. </a>
  59. <br />
  60. <b>3. 4-Step AI Provider Setup Wizard</b><br />
  61. <sub>16+ Local &amp; Cloud LLMs (Ollama, OpenAI, Claude, Gemini, ComfyUI, SearXNG)</sub>
  62. </td>
  63. </tr>
  64. </table>
  65. </div>
  66. ---
  67. ## Why LumenPitch?
  68. Most AI presentation builders lock your sensitive documents inside proprietary clouds, force you into rigid cookie-cutter layouts, and charge recurring per-seat subscriptions on top of marked-up token costs.
  69. **LumenPitch** flips the paradigm. It is a self-hosted, privacy-first **AI Presentation Studio** combining a modern **Next.js 16** slide editor, a high-concurrency **FastAPI + SQLModel** generation engine, a **Template V2 Vision compiler** that turns any `.pptx` into reusable schema-validated layouts, and a native **Electron** desktop runtime.
  70. | Capability | Cloud SaaS Slide Tools | Generic Markdown-to-Slide Scripts | **LumenPitch Studio** |
  71. | :--- | :--- | :--- | :--- |
  72. | **Data & Document Privacy** | Uploaded to 3rd-party multi-tenant cloud | Local, but no document parsing pipeline | **100% Self-Hosted** (Local SQLite/DB + LiteParse OCR/PDF ingestion) |
  73. | **LLM Freedom (BYOK & Local)** | Locked to vendor's default model | Limited API hooks | **16+ Providers**: Ollama, LM Studio, OpenAI, Claude, Gemini, Bedrock, DeepSeek, OpenRouter, vLLM |
  74. | **Generation Modes** | Single rigid flow | Static Markdown | **Dual Engine**: **Standard Mode** (outline review + certified layouts) & **Smart Mode** (real-time streaming adaptive UI) |
  75. | **Custom `.pptx` Ingestion** | Manual recreation required | Not supported | **Template V2 Vision Pipeline**: Multi-pass VLM compiler converts real PPTX decks into structured, editable layouts |
  76. | **Image & Asset Pipeline** | Paid credits required | Manual image links | **ComfyUI, OpenAI, Gemini, Open WebUI, Pexels, Pixabay** + automated icon hydration |
  77. | **Live Web Grounding** | Often paywalled | None | **SearXNG (Self-Hosted), Tavily, Exa, Brave Search, Serper** |
  78. | **Agent Integration (MCP)** | Closed ecosystem | None | **Built-in Model Context Protocol (MCP) Server** exposing generation tools to AI agents |
  79. ---
  80. ## Visual Showcase & Platform Tour
  81. > [!NOTE]
  82. > All screenshots below are captured directly from a real, authenticated local LumenPitch installation (`1440×1000` viewport). Empty libraries and unconfigured provider states reflect a clean out-of-the-box setup with zero fabricated company data or hardcoded keys.
  83. ### 1. The Creative Studio Workspace (`My Workspace`)
  84. ![LumenPitch Workspace and Presentation Library](docs/images/dashboard.png)
  85. The **LumenPitch Creative Studio** (`servers/nextjs/app/(presentation-generator)/dashboard`) serves as your central command center:
  86. - **Hero Launchpad ("From Idea to Impact"):** Jump straight into presentation creation with document uploads (PDF, DOCX, PPTX, TXT via `@llamaindex/liteparse`), custom instructions, slide count controls, and live web-grounding toggles.
  87. - **Dual Creation Entry Points:**
  88. - **Create with AI:** Launch the guided LLM pipeline (outline generation, template pairing, and schema-driven slide hydration).
  89. - **Start from Scratch:** Open the interactive canvas editor immediately using any certified layout.
  90. - **Presentation Library & Instant Search:** Filter decks by title or summary, sort chronologically, and toggle between visual grid cards and compact executive list views.
  91. - **Zero-Barrier Exploration:** Browse the workspace and inspect all built-in templates before configuring a single AI provider key.
  92. <table>
  93. <tr>
  94. <td align="center" width="33%">
  95. <img src="servers/nextjs/public/create_presentation_card_1.png" width="220" alt="Pitch Deck Card Preview" />
  96. <br />
  97. <sub><b>Pitch Decks & GTM Strategy</b></sub>
  98. </td>
  99. <td align="center" width="33%">
  100. <img src="servers/nextjs/public/create_presentation_card_2.png" width="220" alt="Annual Report Card Preview" />
  101. <br />
  102. <sub><b>Annual & Financial Reports</b></sub>
  103. </td>
  104. <td align="center" width="33%">
  105. <img src="servers/nextjs/public/create_presentation_card_3.png" width="220" alt="Business Outcomes Card Preview" />
  106. <br />
  107. <sub><b>Executive Business Reviews</b></sub>
  108. </td>
  109. </tr>
  110. </table>
  111. ---
  112. ### 2. Multi-Layout Template Library & Custom Template V2 Studio
  113. ![LumenPitch Template Library](docs/images/templates.png)
  114. The **Template Library** (`servers/nextjs/app/(presentation-generator)/templates`) manages both **Built-In** studio systems and **Custom Template V2** designs imported from your own PowerPoint files:
  115. - **16 Production-Ready Design Systems:** Over **400+ individual certified slide layouts** spanning 16 distinct visual themes (from *Civic* with 29 layouts and *Mosaic* with 34 layouts to *Dynamic* and *Executive* with 32 layouts each).
  116. - **Instant Filtering & Inspection:** Search by title or keyword (`⌘K`), inspect layout counts, and preview typography and color roles before generating.
  117. - **Custom `.pptx` to Template V2 Compiler (`New Template`):** Upload any existing corporate `.pptx` deck along with custom brand fonts. LumenPitch renders slide previews and runs four parallel vision-model passes—detecting charts/tables/gauges, classifying semantic components, identifying repeatable card grids, and calculating safe text capacity—to compile a reusable, schema-validated template.
  118. ---
  119. ### 3. Privacy-First AI Provider Setup & Local Model Orchestration
  120. ![LumenPitch AI Provider Setup](docs/images/setup.png)
  121. The **4-Step Provider Setup Wizard** (`Text Provider` → `Image Provider` → `Web Search` → `Finish Setup`) gives you total control over where your data and inference run:
  122. 1. **Text Generation Settings:**
  123. - **ChatGPT / Codex OAuth:** Sign in directly with your ChatGPT account on `localhost:1455` without managing API keys.
  124. - **Local Inference:** Run 100% offline or on-premise with **Ollama**, **LM Studio**, **LiteLLM**, or any **OpenAI-compatible** local server (vLLM, llama.cpp).
  125. - **Cloud AI Providers:** Native integrations for **OpenAI**, **Anthropic Claude**, **Google Gemini**, **Vertex AI**, **AWS Bedrock**, **Azure OpenAI**, **DeepSeek**, **OpenRouter**, **Fireworks**, **Together AI**, and **Cerebras**.
  126. - **Advanced Reasoning Controls:** Fine-tune max output tokens, extended reasoning modes, thinking budgets, and OpenRouter zero-data-retention (`OPENROUTER_ZDR`) policies.
  127. 2. **Image & Visual Asset Providers:** Connect **ComfyUI** (custom local JSON workflows), **OpenAI GPT-Image**, **Google Gemini**, **Open WebUI**, **Pexels**, or **Pixabay** with parallel image generation (`ENABLE_PARALLEL_IMAGE_GENERATION=true`).
  128. 3. **Web Grounding & Search Engines:** Ground slide facts in real-time web citations using self-hosted **SearXNG**, **Tavily**, **Exa**, **Brave Search**, or **Serper**.
  129. ---
  130. ### 4. Dual Presentation Generation Modes: `Standard` vs. `Smart`
  131. LumenPitch supports two distinct generation pipelines, configurable globally via `PRESENTATION_GENERATION_MODE=both|standard|smart` (see [`docs/presentation-generation-modes.md`](./docs/presentation-generation-modes.md)):
  132. <table>
  133. <tr>
  134. <td align="center" width="50%">
  135. <img src="servers/nextjs/public/generate/standard-preview.svg" width="360" alt="LumenPitch Standard Generation Mode" />
  136. <br />
  137. <b>Standard Mode (Outline + Certified Templates)</b>
  138. <p align="left">
  139. <sub>Uses predefined, certified <code>1280×720</code> layouts for predictable brand compliance. Includes an interactive <b>Outline Review & Reordering</b> step, pairs each slide with the optimal layout schema from any Built-In or Custom V2 template, and hydrates text, charts, tables, and icons with strict geometry validation.</sub>
  140. </p>
  141. </td>
  142. <td align="center" width="50%">
  143. <img src="servers/nextjs/public/generate/smart-preview.svg" width="360" alt="LumenPitch Smart Generation Mode" />
  144. <br />
  145. <b>Smart Mode (Adaptive Real-Time Streaming)</b>
  146. <p align="left">
  147. <sub>Uses adaptive, content-responsive layouts that stream directly into the slide editor via Server-Sent Events (SSE). Ideal for rapid brainstorming, dynamic data storytelling, and zero-friction drafting without selecting a fixed template upfront.</sub>
  148. </p>
  149. </td>
  150. </tr>
  151. </table>
  152. ---
  153. ## 16 Bundled Studio Templates Gallery
  154. Every installation of LumenPitch ships with **16 curated presentation systems** stored in `templates/` ([Private Source Vault](./SOURCE_ACCESS.md)). Each template includes dozens of specialized slide layouts (cover slides, KPI dashboards, comparison matrices, timelines, data charts, and executive summaries):
  155. <table>
  156. <tr>
  157. <td align="center" width="25%">
  158. <img src="templates/civic/static/thumbnail.png" width="210" alt="Civic Template" />
  159. <br />
  160. <b>Civic</b> · <sub>29 Layouts</sub>
  161. <br />
  162. <sub>Policy, research & behavioral insights</sub>
  163. </td>
  164. <td align="center" width="25%">
  165. <img src="templates/dynamic/static/thumbnail.png" width="210" alt="Dynamic Template" />
  166. <br />
  167. <b>Dynamic</b> · <sub>32 Layouts</sub>
  168. <br />
  169. <sub>High-contrast GTM & strategic roadmaps</sub>
  170. </td>
  171. <td align="center" width="25%">
  172. <img src="templates/editorial/static/thumbnail.png" width="210" alt="Editorial Template" />
  173. <br />
  174. <b>Editorial</b> · <sub>24 Layouts</sub>
  175. <br />
  176. <sub>Annual reports, ESG & executive publications</sub>
  177. </td>
  178. <td align="center" width="25%">
  179. <img src="templates/executive/static/thumbnail.png" width="210" alt="Executive Template" />
  180. <br />
  181. <b>Executive</b> · <sub>32 Layouts</sub>
  182. <br />
  183. <sub>SaaS platforms, product launches & board decks</sub>
  184. </td>
  185. </tr>
  186. <tr>
  187. <td align="center" width="25%">
  188. <img src="templates/general/static/thumbnail.png" width="210" alt="General Template" />
  189. <br />
  190. <b>General</b> · <sub>12 Layouts</sub>
  191. <br />
  192. <sub>Clean all-purpose product & team overviews</sub>
  193. </td>
  194. <td align="center" width="25%">
  195. <img src="templates/horizon/static/thumbnail.png" width="210" alt="Horizon Template" />
  196. <br />
  197. <b>Horizon</b> · <sub>28 Layouts</sub>
  198. <br />
  199. <sub>warm architectural & portfolio showcases</sub>
  200. </td>
  201. <td align="center" width="25%">
  202. <img src="templates/landmark/static/thumbnail.png" width="210" alt="Landmark Template" />
  203. <br />
  204. <b>Landmark</b> · <sub>27 Layouts</sub>
  205. <br />
  206. <sub>Bold geometric layouts for capital & enterprise</sub>
  207. </td>
  208. <td align="center" width="25%">
  209. <img src="templates/modern/static/thumbnail.png" width="210" alt="Modern Template" />
  210. <br />
  211. <b>Modern</b> · <sub>10 Layouts</sub>
  212. <br />
  213. <sub>Crisp blue-accented startup pitch decks</sub>
  214. </td>
  215. </tr>
  216. <tr>
  217. <td align="center" width="25%">
  218. <img src="templates/momentum/static/thumbnail.png" width="210" alt="Momentum Template" />
  219. <br />
  220. <b>Momentum</b> · <sub>28 Layouts</sub>
  221. <br />
  222. <sub>Revenue velocity, QBRs & sales reports</sub>
  223. </td>
  224. <td align="center" width="25%">
  225. <img src="templates/mosaic/static/thumbnail.png" width="210" alt="Mosaic Template" />
  226. <br />
  227. <b>Mosaic</b> · <sub>34 Layouts</sub>
  228. <br />
  229. <sub>Creative campaigns & marketing performance</sub>
  230. </td>
  231. <td align="center" width="25%">
  232. <img src="templates/nova/static/thumbnail.png" width="210" alt="Nova Template" />
  233. <br />
  234. <b>Nova</b> · <sub>28 Layouts</sub>
  235. <br />
  236. <sub>Deep-tech, macro trends & future economy</sub>
  237. </td>
  238. <td align="center" width="25%">
  239. <img src="templates/pulse/static/thumbnail.png" width="210" alt="Pulse Template" />
  240. <br />
  241. <b>Pulse</b> · <sub>28 Layouts</sub>
  242. <br />
  243. <sub>Healthcare, clinical operations & planning</sub>
  244. </td>
  245. </tr>
  246. <tr>
  247. <td align="center" width="25%">
  248. <img src="templates/signal/static/thumbnail.png" width="210" alt="Signal Template" />
  249. <br />
  250. <b>Signal</b> · <sub>28+ Layouts</sub>
  251. <br />
  252. <sub>Digital growth, agency briefs & media</sub>
  253. </td>
  254. <td align="center" width="25%">
  255. <img src="templates/standard/static/thumbnail.png" width="210" alt="Standard Template" />
  256. <br />
  257. <b>Standard</b> · <sub>Classic Layouts</sub>
  258. <br />
  259. <sub>Editorial serif typography for formal pitches</sub>
  260. </td>
  261. <td align="center" width="25%">
  262. <img src="templates/swift/static/thumbnail.png" width="210" alt="Swift Template" />
  263. <br />
  264. <b>Swift</b> · <sub>Minimal Layouts</sub>
  265. <br />
  266. <sub>Lightweight minimalist slides for fast briefings</sub>
  267. </td>
  268. <td align="center" width="25%">
  269. <img src="templates/verdant/static/thumbnail.png" width="210" alt="Verdant Template" />
  270. <br />
  271. <b>Verdant</b> · <sub>Data & Research</sub>
  272. <br />
  273. <sub>Organic emerald aesthetics for data storytelling</sub>
  274. </td>
  275. </tr>
  276. </table>
  277. ---
  278. ## Supported AI Providers & Ecosystem
  279. LumenPitch natively integrates with the leading open-source and commercial AI infrastructure. All provider icons below live in [`servers/nextjs/public/providers/`](./servers/nextjs/public/providers):
  280. <table>
  281. <tr>
  282. <td align="center" width="12.5%">
  283. <img src="servers/nextjs/public/providers/ollama.svg" width="36" height="36" alt="Ollama" /><br /><sub><b>Ollama</b></sub>
  284. </td>
  285. <td align="center" width="12.5%">
  286. <img src="servers/nextjs/public/providers/lm-studio.svg" width="36" height="36" alt="LM Studio" /><br /><sub><b>LM Studio</b></sub>
  287. </td>
  288. <td align="center" width="12.5%">
  289. <img src="servers/nextjs/public/providers/openai.png" width="36" height="36" alt="OpenAI" /><br /><sub><b>OpenAI</b></sub>
  290. </td>
  291. <td align="center" width="12.5%">
  292. <img src="servers/nextjs/public/providers/claude-color.svg" width="36" height="36" alt="Anthropic Claude" /><br /><sub><b>Claude</b></sub>
  293. </td>
  294. <td align="center" width="12.5%">
  295. <img src="servers/nextjs/public/providers/gemini-color.svg" width="36" height="36" alt="Google Gemini" /><br /><sub><b>Gemini</b></sub>
  296. </td>
  297. <td align="center" width="12.5%">
  298. <img src="servers/nextjs/public/providers/deepseek-color.svg" width="36" height="36" alt="DeepSeek" /><br /><sub><b>DeepSeek</b></sub>
  299. </td>
  300. <td align="center" width="12.5%">
  301. <img src="servers/nextjs/public/providers/openrouter-color.svg" width="36" height="36" alt="OpenRouter" /><br /><sub><b>OpenRouter</b></sub>
  302. </td>
  303. <td align="center" width="12.5%">
  304. <img src="servers/nextjs/public/providers/litellm-logo.svg" width="36" height="36" alt="LiteLLM" /><br /><sub><b>LiteLLM</b></sub>
  305. </td>
  306. </tr>
  307. <tr>
  308. <td align="center" width="12.5%">
  309. <img src="servers/nextjs/public/providers/bedrock-color.svg" width="36" height="36" alt="Amazon Bedrock" /><br /><sub><b>Bedrock</b></sub>
  310. </td>
  311. <td align="center" width="12.5%">
  312. <img src="servers/nextjs/public/providers/azure-color.svg" width="36" height="36" alt="Azure OpenAI" /><br /><sub><b>Azure AI</b></sub>
  313. </td>
  314. <td align="center" width="12.5%">
  315. <img src="servers/nextjs/public/providers/vertexai-color.svg" width="36" height="36" alt="Google Vertex AI" /><br /><sub><b>Vertex AI</b></sub>
  316. </td>
  317. <td align="center" width="12.5%">
  318. <img src="servers/nextjs/public/providers/fireworks-color.svg" width="36" height="36" alt="Fireworks AI" /><br /><sub><b>Fireworks</b></sub>
  319. </td>
  320. <td align="center" width="12.5%">
  321. <img src="servers/nextjs/public/providers/together-color.svg" width="36" height="36" alt="Together AI" /><br /><sub><b>Together</b></sub>
  322. </td>
  323. <td align="center" width="12.5%">
  324. <img src="servers/nextjs/public/providers/cerebras-color.svg" width="36" height="36" alt="Cerebras" /><br /><sub><b>Cerebras</b></sub>
  325. </td>
  326. <td align="center" width="12.5%">
  327. <img src="servers/nextjs/public/providers/comfyui-color.svg" width="36" height="36" alt="ComfyUI" /><br /><sub><b>ComfyUI</b></sub>
  328. </td>
  329. <td align="center" width="12.5%">
  330. <img src="servers/nextjs/public/providers/searxng.svg" width="36" height="36" alt="SearXNG" /><br /><sub><b>SearXNG</b></sub>
  331. </td>
  332. </tr>
  333. </table>
  334. ---
  335. ## Architecture & Tech Stack
  336. LumenPitch is architected as a decoupled, multi-target platform that runs identically inside a single unified Docker container (via Nginx + `start.js`), a local multi-process developer environment, or a packaged **Electron** desktop app.
  337. ```mermaid
  338. flowchart TB
  339. subgraph Client["Presentation Studio & Desktop Shell"]
  340. UI["Next.js 16 + React Slide Studio<br/>(servers/nextjs)"]
  341. Desktop["Electron Desktop Runtime<br/>(electron/)"]
  342. MCP["MCP Client / AI Agents"]
  343. end
  344. subgraph Core["FastAPI Generation & Persistence Engine (servers/fastapi)"]
  345. API["FastAPI REST & SSE Streaming API<br/>(server.py / api/v1/ppt)"]
  346. Auth["Session Auth & Provider Config<br/>(USER_CONFIG_PATH)"]
  347. DocParser["Document Ingestion & LiteParse OCR<br/>(@llamaindex/liteparse)"]
  348. T2["Template V2 Vision Compiler<br/>(Multi-Pass VLM Certification)"]
  349. Gen["Outline & Schema-Conforming<br/>Slide Hydration Engine"]
  350. Mem["Contextual Memory Layer<br/>(Mem0 + FastEmbed + spaCy)"]
  351. DB[("SQLModel + Alembic DB<br/>(SQLite / PostgreSQL)")]
  352. end
  353. subgraph Providers["Pluggable AI, Visual & Search Providers"]
  354. LLMs["16+ LLM Backends<br/>(Ollama, OpenAI, Claude, Gemini, Bedrock, DeepSeek, OpenRouter)"]
  355. ImgGen["Image & Icon Hydration<br/>(ComfyUI, GPT-Image, Gemini, Pexels, Pixabay)"]
  356. Search["Web Grounding<br/>(SearXNG, Tavily, Exa, Brave, Serper)"]
  357. end
  358. subgraph Export["Presentation Export & Conversion Runtime"]
  359. ExpEngine["Puppeteer Chromium + Export Core<br/>(@lumenpitch/export-core)"]
  360. Outputs["Editable PPTX & High-DPI PDF Decks"]
  361. end
  362. Desktop --> UI
  363. UI <-->|"REST + Server-Sent Events (SSE)"| API
  364. MCP <-->|"Model Context Protocol"| API
  365. API --> Auth
  366. API --> DocParser
  367. API --> T2
  368. API --> Gen
  369. API --> Mem
  370. API <--> DB
  371. T2 <-->|"Vision + Structured JSON"| LLMs
  372. Gen <-->|"Structured Output / Streaming"| LLMs
  373. Gen <--> ImgGen
  374. Gen <--> Search
  375. API --> ExpEngine
  376. ExpEngine --> Outputs
  377. ```
  378. ### Component Breakdown
  379. | Directory ([Private Source Vault](./SOURCE_ACCESS.md)) | Responsibility | Key Technologies |
  380. | :--- | :--- | :--- |
  381. | `servers/nextjs/` ([Unlock Source](./SOURCE_ACCESS.md)) | Web application, interactive slide canvas editor, Template V2 visual studio, provider onboarding wizard, and export triggers | Next.js `16.4.6`, React, TypeScript, Tailwind CSS, Redux Toolkit |
  382. | `servers/fastapi/` ([Unlock Source](./SOURCE_ACCESS.md)) | REST & SSE streaming API, multi-LLM orchestration, Template V2 vision certification, Mem0 memory, MCP server, and persistence | Python `3.11`, FastAPI, SQLModel, Alembic, LiteLLM, Pydantic |
  383. | `electron/` ([Unlock Source](./SOURCE_ACCESS.md)) | Cross-platform desktop packaging, lifecycle management, local process supervision, and IPC security boundaries | Electron, TypeScript, Electron Builder |
  384. | `templates/` ([Unlock Source](./SOURCE_ACCESS.md)) | 16 bundled presentation template systems with certified slide layouts, static thumbnails, and vector assets | JSON Layout Schemas, SVG/PNG Assets |
  385. | `scripts/` ([Unlock Source](./SOURCE_ACCESS.md)) | Template conversion utilities, export runtime synchronization (`sync-presentation-export.cjs`), and read-only diagnostics (`project-health.mjs`) | Node.js ESM/CJS, Python |
  386. | [`docs/`](./docs/) | Architectural specifications, Template V2 deep dive, generation modes guide, k6 load-testing telemetry, and validation reports | Markdown, Mermaid Diagrams |
  387. ### Deep-Dive Documentation
  388. - **[`SOURCE_ACCESS.md`](./SOURCE_ACCESS.md)** — 3-step guide to unlock the private `annoris/lumenpitch-pro-source` repository via Solana (`3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm`).
  389. - **[`PAYMENT.md`](./PAYMENT.md)** — Commercial white-label licensing tiers, QR code, and Solana verification instructions.
  390. - **[`SPONSORS.md`](./SPONSORS.md)** — Hall of Patrons and institutional sponsors.
  391. - **[`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md)** — Core component boundaries, runtime contract, and verification commands.
  392. - **[`docs/PROJECT_STRUCTURE.md`](./docs/PROJECT_STRUCTURE.md)** — Repository folder map and contributor workflow rules.
  393. - **[`docs/template-v2.md`](./docs/template-v2.md)** — End-to-end architecture of the **Template V2 Vision Compiler** (how source `.pptx` decks and slide screenshots are analyzed in parallel to produce certified, schema-validated `1280×720` layouts).
  394. - **[`docs/presentation-generation-modes.md`](./docs/presentation-generation-modes.md)** — Complete guide to configuring `PRESENTATION_GENERATION_MODE` (`both`, `standard`, `smart`) across Docker, source deployments, and the MCP server.
  395. - **[`docs/amazon-bedrock.md`](./docs/amazon-bedrock.md)** — Enterprise configuration guide for AWS Bedrock authentication and model selection.
  396. - **[`docs/lumenpitch-resource-usage.md`](./docs/lumenpitch-resource-usage.md)** — 51-minute controlled **k6 concurrency & resource telemetry report** (16 complete 10–40 slide generation workflows across 4 concurrent virtual user waves with `0.00%` HTTP failure rate).
  397. - **[`docs/VALIDATION.md`](./docs/VALIDATION.md)** — Real test execution results (164 Next.js tests, 47 root converter/security tests, 40 FastAPI configuration tests, 14 Electron security tests).
  398. ---
  399. ## Installation & Verified Contributor Access Gate (Solana Pay)
  400. > [!IMPORTANT]
  401. > **Solana-Gated Sponsorware Architecture (`annoris/lumenpitch-pro-source`):**
  402. > - **Interactive Live Web & Mobile App Studio:** Explore the studio UI right now at **[https://annoris.github.io/lumenpitch/](https://annoris.github.io/lumenpitch/)**
  403. > - **Full Editable Full-Stack Source Vault (`annoris/lumenpitch-pro-source`):** The complete, unminified full-stack platform (`servers/nextjs/`, `servers/fastapi/`, `electron/`, `templates/`, `scripts/`, `Dockerfile`, and `docker-compose.yml`) is hosted inside the private repository **`annoris/lumenpitch-pro-source`**.
  404. > - **How to Unlock Full Clone & Download Access:**
  405. > 1. Send your contribution in **SOL** or **USDC-SPL** (**$75 – $149 USD** Individual Unlock / **$450 USD** Studio License / **$1,500 USD** Enterprise License) on Solana Mainnet to **`3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm`**.
  406. > 2. Submit your transaction signature (`txSig`) in a **[🔓 Solana Source Code Unlock Request](https://github.com/annoris/lumenpitch/issues/new?template=source_unlock_request.md)** (or [Release Access Claim Issue](https://github.com/annoris/lumenpitch/issues/new?template=claim-release-access.yml)).
  407. > 3. Your GitHub account will receive a collaborator invitation to **`https://github.com/annoris/lumenpitch-pro-source`**. See [`SOURCE_ACCESS.md`](./SOURCE_ACCESS.md) and [`PAYMENT.md`](./PAYMENT.md).
  408. ### Prerequisites (Once Your GitHub Account Is Verified & Invited)
  409. - **Node.js** `22.12+` & **npm**
  410. - **Python** `3.11` & **[uv](https://github.com/astral-sh/uv)** (fast Python package & lockfile manager)
  411. ### Option 1: Local Multi-Process Development (For Verified Contributors)
  412. 1. **Clone the private source vault (`annoris/lumenpitch-pro-source`) and initialize your environment file:**
  413. ```bash
  414. git clone https://github.com/annoris/lumenpitch-pro-source.git
  415. cd lumenpitch-pro-source
  416. cp .env.example .env
  417. ```
  418. 2. **Install root dependencies and run the read-only project diagnostics check:**
  419. ```bash
  420. npm ci
  421. npm run doctor
  422. ```
  423. 3. **Start the FastAPI backend engine (`port 8000`):**
  424. ```bash
  425. cd servers/fastapi
  426. uv sync --locked --dev
  427. uv run python server.py --port 8000
  428. ```
  429. 4. **In a second terminal, start the Next.js studio interface (`port 3000`):**
  430. ```bash
  431. cd servers/nextjs
  432. npm ci
  433. npm run dev
  434. ```
  435. 5. **Open [http://localhost:3000](http://localhost:3000)** in your browser, create your local administrator account, and configure your preferred AI provider (or browse the workspace and 16 templates immediately).
  436. ---
  437. ### Option 2: Docker Compose Deployment
  438. LumenPitch includes production and development profiles in `docker-compose.yml` ([Private Source Vault](./SOURCE_ACCESS.md), with optional NVIDIA GPU passthrough via `production-gpu` and `development-gpu`).
  439. ```bash
  440. # 1. Configure your environment variables in .env
  441. cp .env.example .env
  442. # 2. Launch the production service on http://localhost:5001
  443. docker compose up --build production
  444. ```
  445. > [!IMPORTANT]
  446. > **Export Engine Contract (`@lumenpitch/export-core`):**
  447. > Exports and conversions require a compatible external export archive authorized by the operator. No proprietary export binary is bundled or downloaded from an unverified third party by default.
  448. > - For local builds, synchronize an authorized `.tgz` archive:
  449. > ```bash
  450. > EXPORT_CORE_ARCHIVE=/authorized/path/export-core.tgz npm run sync:presentation-export
  451. > npm run check:presentation-export
  452. > ```
  453. > - For Docker builds, set `EXPORT_CORE_DOWNLOAD_BASE` to an authorized release server you control, or provide the archive via a BuildKit secret.
  454. ---
  455. ### Environment Configuration Reference (`.env`)
  456. All runtime storage paths (`APP_DATA_DIRECTORY`, `TEMP_DIRECTORY`, `USER_CONFIG_PATH`, and `DATABASE_URL`) are kept outside the Git working tree:
  457. ```dotenv
  458. # Core Paths & Persistence
  459. APP_DATA_DIRECTORY=/tmp/lumenpitch-data
  460. TEMP_DIRECTORY=/tmp/lumenpitch-temp
  461. USER_CONFIG_PATH=/tmp/lumenpitch-data/userConfig.json
  462. DATABASE_URL=sqlite+aiosqlite:////tmp/lumenpitch-data/lumenpitch.db
  463. # Application Endpoints & Mode
  464. NEXT_PUBLIC_APP_NAME=LumenPitch
  465. NEXT_PUBLIC_FAST_API=http://localhost:8000
  466. NEXT_PUBLIC_URL=http://localhost:3000
  467. PRESENTATION_GENERATION_MODE=both # Options: both | standard | smart
  468. ```
  469. ---
  470. ### Verification & Health Checks
  471. Run the built-in test suites and read-only diagnostics at any time:
  472. ```bash
  473. # 1. Read-only structural & toolchain health check
  474. npm run doctor
  475. # 2. Root template-converter, security & metadata tests (47 tests)
  476. npm test
  477. # 3. Next.js frontend unit tests, typecheck & production build (164 tests)
  478. cd servers/nextjs
  479. npm test
  480. npx tsc --noEmit
  481. npm run build
  482. # 4. FastAPI backend test suite (Python 3.11)
  483. cd ../fastapi
  484. uv sync --locked --dev
  485. uv run --locked python -m pytest
  486. # 5. Electron desktop typecheck & security boundary tests (14 tests)
  487. cd ../../electron
  488. npm run typecheck
  489. npm run test:security
  490. ```
  491. ---
  492. ## Support & Crypto Sponsorship (Solana)
  493. ### Sponsor Open-Source Development or Unlock Pre-Built Release Access via Solana
  494. Building and maintaining an enterprise-grade, multi-LLM AI presentation studio requires continuous engineering across vision pipelines, layout compilers, and local AI runtimes.
  495. Whether you want to **sponsor LumenPitch's open-source development** with a donation of any amount in **SOL** / **USDC-SPL**, or unlock **pre-built release installers, distribution archives, and private release repository access** with a **$149 USD one-time contribution**, you can contribute directly on the **Solana** network:
  496. <table>
  497. <tr>
  498. <td align="center" width="320">
  499. <img src="docs/images/solana-pay-qr.png" width="280" alt="Official Receive SOL QR Code for 3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm" />
  500. <br />
  501. <sub><b>Scan with Phantom, Solflare, Backpack, Coinbase, Binance, or Trust Wallet</b></sub>
  502. </td>
  503. <td valign="top">
  504. <h4>Official Solana (SOL / USDC-SPL) Wallet Address</h4>
  505. <pre><code>3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm</code></pre>
  506. <p><b>1-Step QR Payment:</b> Simply open your Solana wallet app, tap <b>Send / Scan QR</b>, and scan the official <b>Receive SOL</b> QR code on the left (or copy the wallet address above).</p>
  507. <p><b>One-Time Perpetual Release &amp; Source Vault License:</b> <code>$149 USD</code> (in SOL at live rate or <code>149 USDC-SPL</code>) — or send any amount to support open-source development!</p>
  508. </td>
  509. </tr>
  510. </table>
  511. ### Automated On-Chain Verification & Release Access Claim ($149 USD Tier)
  512. 1. **Send `$149 USD` in SOL (or `149 USDC-SPL`)** on Solana Mainnet to:
  513. ```text
  514. 3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm
  515. ```
  516. 2. **Include your GitHub username in the Solana transaction Memo** (for automated GitHub repository invitations):
  517. ```text
  518. gh:<your-github-username>
  519. ```
  520. *(Example: if your GitHub username is `octocat`, set the transaction memo to `gh:octocat`.)*
  521. 3. **Verify On-Chain & Unlock Immediately:**
  522. - **On GitHub (Automated Private Vault Invite):** Open a **[🔓 Solana Source Code Unlock Request](https://github.com/annoris/lumenpitch/issues/new?template=source_unlock_request.md)** (or [Release Access Claim Issue](https://github.com/annoris/lumenpitch/issues/new?template=claim-release-access.yml)) with your **Solana Transaction Signature (`txSig`)** and your GitHub username.
  523. - **In the LumenPitch App:** Paste your confirmed Solana Transaction Signature directly into the in-app **Solana License & Release Gate** screen to verify your transaction on-chain and unlock the workspace immediately.
  524. ---
  525. ## Roadmap
  526. - [x] **Multi-Provider LLM Engine** — 16+ cloud and local providers (Ollama, LM Studio, OpenAI, Anthropic, Gemini, Bedrock, Vertex, Azure, DeepSeek, OpenRouter, Cerebras).
  527. - [x] **Template V2 Vision Compiler** — Multi-pass vision-language certification pipeline converting `.pptx` files into schema-validated layouts.
  528. - [x] **16 Studio Design Systems** — 400+ built-in slide layouts across 16 professional themes.
  529. - [x] **Dual Generation Workflows** — Standard outline-driven mode and Smart real-time SSE streaming mode.
  530. - [x] **Model Context Protocol (MCP) Server** — Expose LumenPitch deck generation tools directly to external AI agents.
  531. - [x] **Solana Mainnet Verification Gate** — Automated on-chain payment & memo verification via GitHub Actions and in-app RPC checks.
  532. - [ ] **Collaborative Multi-User Workspaces** — Real-time cursor presence and role-based slide commenting.
  533. - [ ] **Interactive Chart & Live Data Connectors** — Direct SQL / CSV / REST bindings for auto-updating chart slides.
  534. - [ ] **Plugin SDK for Custom Slide Widgets** — Extensible React component registry for domain-specific visual blocks.
  535. ---
  536. ## Contributing
  537. Contributions, bug reports, security audits, and new template designs are warmly welcomed! Before making cross-component changes, please review:
  538. 1. **[`AGENTS.md`](./AGENTS.md)** — Collaboration guidelines and component boundaries.
  539. 2. **[`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md)** — System architecture and runtime verification rules.
  540. 3. **[`docs/PROJECT_STRUCTURE.md`](./docs/PROJECT_STRUCTURE.md)** — Folder map and instructions for adding new features cleanly.
  541. ```bash
  542. # Run diagnostics and tests before opening a Pull Request:
  543. npm run doctor
  544. npm test
  545. ```
  546. ---
  547. ## Star This Repository
  548. If **LumenPitch** helps you build better presentations, saves your team hours of slide formatting, or inspires your local AI workflows:
  549. - **Give this repository a Star on GitHub** (top-right corner) — it helps more developers and creators discover open-source AI tooling!
  550. - **Share LumenPitch** on X (Twitter), Hacker News, Reddit (`r/LocalLLaMA`, `r/selfhosted`), and LinkedIn.
  551. - **Sponsor via Solana** (`3HvUMCUSSHEdtA35UuD4J7mbgpTxJ7LgT2X7GfdzvBdm`) to accelerate upcoming releases.
  552. ---
  553. ## License & Attribution
  554. Distributed under the **Commercial & Sponsorware Source-Gated License (On-Chain Solana Treasury Edition)**. See [`LICENSE`](./LICENSE), [`SOURCE_ACCESS.md`](./SOURCE_ACCESS.md), [`PAYMENT.md`](./PAYMENT.md), [`SPONSORS.md`](./SPONSORS.md), and [`NOTICE`](./NOTICE) for full legal attribution, commercial licensing tiers, and third-party notices.
  555. <div align="center">
  556. <br />
  557. <img src="docs/images/lumenpitch-logo.svg" width="42" height="42" alt="LumenPitch Mark" />
  558. <br />
  559. <sub><b>LumenPitch</b> — Clear ideas. Presentations that connect.</sub>
  560. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.