Metadata-Version: 2.4
Name: shipai-micro-saas
Version: 2.0.0
Summary: ShipAI v2.0 — FastAPI + Google Gemini AI Micro-SaaS Boilerplate & 5 Vertical SaaS Presets
Home-page: https://razio05.github.io
Author: ShipAI Studio
License: MIT
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: summary

# 🌟 Awesome FastAPI + Google Gemini AI Micro-SaaS (2026 Architecture & Templates)

[![Awesome](https://awesome.re/badge.svg)](https://github.com/RAZIO05/fastapi-gemini-2026-blueprint)
[![Python 3.10-3.13](https://img.shields.io/badge/Python-3.10--3.13-blue.svg)](https://yahiaoui26.gumroad.com/l/fastapi-gemini-blueprint)
[![ShipAI v2.0](https://img.shields.io/badge/ShipAI%20v2.0-Live%20Interactive%20Sandbox-brightgreen.svg)](https://yahiaoui26.gumroad.com/l/shipai-pro)

A curated 2026 engineering guide and starter collection for building **profitable AI Micro-SaaS applications** with **Python**, **FastAPI**, **Pydantic v2**, **Streamlit**, and the official **Google Gemini (`google-genai`) SDK**.

<p align="center">
  <a href="https://yahiaoui26.gumroad.com/l/shipai-pro/LAUNCH20">
    <img src="https://public-files.gumroad.com/00b6jvp3mssqjd59jm1ax12xa5q9" alt="ShipAI v2.0 Commercial Micro-SaaS Boilerplate" width="100%" />
  </a>
</p>

---

## 📚 Contents

1. [Free 2026 Architecture Blueprint & Cheat Sheet ($0)](#1-free-2026-architecture-blueprint--cheat-sheet-0)
2. [5 High-Margin B2B AI Micro-SaaS Verticals to Launch in 2026](#2-5-high-margin-b2b-ai-micro-saas-verticals-to-launch-in-2026)
3. [Production Reference Repositories](#3-production-reference-repositories)
4. [Solving the Top 3 Production Pitfalls (Python 3.13 + Gemini)](#4-solving-the-top-3-production-pitfalls-python-313--gemini)

---

## 1. Free 2026 Architecture Blueprint & Cheat Sheet ($0)

Before writing your own JWT middleware or regex parsers, grab the free production cheat sheet covering native `response_mime_type="application/json"` and multi-model Gemini failover:

👉 **[Download Free 2026 Architecture Blueprint ($0 on Gumroad)](https://yahiaoui26.gumroad.com/l/fastapi-gemini-blueprint)**

---

## 2. 5 High-Margin B2B AI Micro-SaaS Verticals to Launch in 2026

All 5 verticals below are pre-built and ready to test inside the **[ShipAI v2.0 Interactive Browser Sandbox](https://yahiaoui26.gumroad.com/l/shipai-pro)**:

| # | Micro-SaaS Vertical | Target B2B Buyer | Typical SaaS Pricing | Preset ID in ShipAI v2.0 |
| :- | :--- | :--- | :--- | :--- |
| **1** | **AI Startup & Micro-SaaS Idea Validator** | Indie Founders & Accelerators | `$29 – $79/mo` | `saas_validator` |
| **2** | **Legal & Freelance MSA Contract Risk Auditor** | Agencies & Consultants | `$49 – $149/mo` | `contract_auditor` |
| **3** | **DevSecOps & OWASP Code Security Reviewer** | Engineering Teams | `$39 – $99/mo` | `code_security_reviewer` |
| **4** | **Executive Resume & ATS Score Optimizer** | Job Seekers & Career Coaches | `$19 – $49/mo` | `resume_ats_optimizer` |
| **5** | **Programmatic SEO & Conversion Copy Architect** | SaaS Marketers | `$49 – $129/mo` | `seo_content_architect` |

---

## 3. Production Reference Repositories

* ⚡ **[RAZIO05/fastapi-gemini-2026-blueprint](https://github.com/RAZIO05/fastapi-gemini-2026-blueprint)** — Open-source reference implementation with Python 3.13 GitHub Actions CI, Pydantic v2 structured JSON schemas, and 3-model Gemini failover.
* 🚀 **[ShipAI v2.0 Commercial Micro-SaaS Engine](https://yahiaoui26.gumroad.com/l/shipai-pro/LAUNCH20)** — Complete commercial boilerplate including:
  * **SaaS User Credit Wallet & HTTP 402 Guard** (`app/monetization.py`)
  * **Live Gumroad License Key Verification API** (`POST /api/v1/billing/activate-license`)
  * **5 Built-In Vertical Micro-SaaS Presets** (`app/presets.py`)
  * **Streamlit v2.0 Executive Dashboard** (`dashboard.py`) + **Docker Compose Stack**

---

## 4. Solving the Top 3 Production Pitfalls (Python 3.13 + Gemini)

1. **`gemini-2.5-flash` HTTP 404 on 2026 API Keys:** Always use a fallback chain starting with `gemini-3.5-flash` -> `gemini-flash-lite-latest` -> `gemini-3.8-flash`.
2. **`passlib[bcrypt]` 72-Byte Crash on Python 3.12/3.13:** Pin `bcrypt==4.0.1` in `requirements.txt`.
3. **Unmetered API Drain:** Never expose an LLM endpoint without per-user credit tracking (`HTTP 402 Payment Required`).
