Open-source AI headshot generator β production-ready Next.js SaaS for LinkedIn photos, team portraits, and personal branding. Stripe billing, credits, NextAuth, and Prisma out of the box.
40
stars
18
commits
JavaScript
primary language
Aug 2, 2026
updated
README
π AI Headshot Generator β Professional Portrait Studio
A beautifully designed, fully-integrated AI headshot studio. Built with Next.js, this open-source template serves as a complete, self-contained SaaS boilerplate for generating high-quality professional portraits and business headshots for LinkedIn, teams, and personal branding.
https://github.com/user-attachments/assets/0ce7f433-1b3d-4525-844f-a7b7628f4bb8
Related Projects
- MuAPI β Unified API for image, video, and audio generation across hundreds of AI models. Try GPT Image 2 in the image playground.
- Awesome-GPT-Image-2-API-Prompts β Curated GPT-Image-2 prompts including headshot styles
- Open-Generative-AI β Free self-hosted studio with 200+ image models
- awesome-ai-image-models β compare AI image models by API, price & quality
π Live Manifestation
Experience the full glassmorphic, responsive interface here. Sign in with Google to explore the Portrait Studio, My Headshots archive, and Booking Tiers directly from your browser.
AI Headshot Generator is not just another wrapper β it's a production-ready, highly-optimized AI web application. Out of the box, it seamlessly manages User Authentication, Credits & Billing, Image Persistence, and asynchronous AI generation polling using a sleek Next.js (App Router) architecture. It empowers you to build professional-grade AI portrait workflows with built-in mobile optimization, making it the perfect starting point for your next AI SaaS.
Why use AI Headshot Generator?
- Production-Ready SaaS β Complete with Google OAuth and Stripe Checkout workflows built-in.
- Dedicated Portrait Studio β Specifically tailored UI for multi-image reference generation and professional style selection.
- Historical Archive β All creations are securely persisted to a PostgreSQL database for a customized user gallery.
- Premium Glassmorphic UX β Dynamic multi-theme support (Indigo, Emerald, Rose, Amber) with high-fidelity micro-animations.
- Extensible Architecture β Easily swap out the underlying AI model while maintaining the premium application UI.
β¨ Core Features
- Kinetic Portrait Studio β Generate stunning professional headshots with text prompts. Includes options for advanced
Aspect Ratiotuning and tiered Resolutions (1K, 2K, 4K) tied directly to a flexible credit cost system. - Multi-Image Reference Mode β Transition smoothly to professional editing. Upload local images or add external URLs to use as visual nodes for complex portrait configurations.
- Secure My Headshots Archive β A dedicated history vault for logged-in users. Displays past portrait sessions securely fetched from the database, viewable in a detailed inspector modal with 1-click downloads.
- Booking Tiers & Billing β Complete Stripe integration. Start users off with a balance, map generations to credit deductions, and seamlessly route them to an interactive pricing page to book sessions (Starter, Professional, Executive).
- Beautiful & Dynamic UI β Built on Tailwind CSS and Framer Motion, ensuring every state transition, loading spinner, and dropdown elegantly guides the user.
β‘ Deployment: Vercel & Production
Deploying an instance of AI Headshot Generator to the web requires minimal configuration. The architecture is engineered explicitly for Vercel serverless environments.
π Required Environment Variables
To successfully deploy and run, you must populate the following environment variables in your Vercel project settings:
| Service | Variable | Description & Source |
|---|---|---|
| Database | DATABASE_URL | PostgreSQL connection string (Supabase or Neon) |
DIRECT_URL | Direct DB connection for Prisma migrations | |
| NextAuth / Google | NEXTAUTH_SECRET | Secure random string generated via openssl rand -base64 32 |
NEXTAUTH_URL | Your production domain (e.g. https://my-app.vercel.app) | |
GOOGLE_CLIENT_ID | Get from Google Cloud Console | |
GOOGLE_CLIENT_SECRET | Get from Google Cloud Console | |
| Stripe Billing | STRIPE_SECRET_KEY | Get from Stripe Dashboard |
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY | Get from Stripe Dashboard | |
STRIPE_WEBHOOK_SECRET | Webhook secret for resolving credit purchases | |
| AI Generator | HEADSHOT_API_KEY | Create an account and get your API key for your targeted headshot model. |
π οΈ Local Development
Ready to iterate locally? Setup is straightforward.
Prerequisites
- Node.js (v18 or higher)
- A local PostgreSQL instance or a free cloud Database URL.
Setup
# 1. Clone the repository
git clone https://github.com/SamurAIGPT/ai-headshot-generator
cd ai-headshot-generator
# 2. Install dependencies
npm install
# 3. Setup Environment
cp .env.example .env
# Open .env and insert your specific keys.
# 4. Initialize Database Schema
npx prisma generate
npx prisma db push
# 5. Start the Development Server
npm run dev
The graphical console should now be heavily responsive on http://localhost:3000.
AI Headshot Generator: A modular, mobile-ready, production-grade AI portrait workspace built for creators and builders.
Contributors
13 commits
5 commits
Similar repos
Languages
JavaScript
95.2%
CSS
4.5%
Open-source AI headshot generator β production-ready Next.js SaaS for LinkedIn photos, team portraits, and personal branding. Stripe billing, credits, NextAuth, and Prisma out of the box.
40
stars
18
commits
JavaScript
primary language
Aug 2, 2026
updated
README
π AI Headshot Generator β Professional Portrait Studio
A beautifully designed, fully-integrated AI headshot studio. Built with Next.js, this open-source template serves as a complete, self-contained SaaS boilerplate for generating high-quality professional portraits and business headshots for LinkedIn, teams, and personal branding.
https://github.com/user-attachments/assets/0ce7f433-1b3d-4525-844f-a7b7628f4bb8
Related Projects
- MuAPI β Unified API for image, video, and audio generation across hundreds of AI models. Try GPT Image 2 in the image playground.
- Awesome-GPT-Image-2-API-Prompts β Curated GPT-Image-2 prompts including headshot styles
- Open-Generative-AI β Free self-hosted studio with 200+ image models
- awesome-ai-image-models β compare AI image models by API, price & quality
π Live Manifestation
Experience the full glassmorphic, responsive interface here. Sign in with Google to explore the Portrait Studio, My Headshots archive, and Booking Tiers directly from your browser.
AI Headshot Generator is not just another wrapper β it's a production-ready, highly-optimized AI web application. Out of the box, it seamlessly manages User Authentication, Credits & Billing, Image Persistence, and asynchronous AI generation polling using a sleek Next.js (App Router) architecture. It empowers you to build professional-grade AI portrait workflows with built-in mobile optimization, making it the perfect starting point for your next AI SaaS.
Why use AI Headshot Generator?
- Production-Ready SaaS β Complete with Google OAuth and Stripe Checkout workflows built-in.
- Dedicated Portrait Studio β Specifically tailored UI for multi-image reference generation and professional style selection.
- Historical Archive β All creations are securely persisted to a PostgreSQL database for a customized user gallery.
- Premium Glassmorphic UX β Dynamic multi-theme support (Indigo, Emerald, Rose, Amber) with high-fidelity micro-animations.
- Extensible Architecture β Easily swap out the underlying AI model while maintaining the premium application UI.
β¨ Core Features
- Kinetic Portrait Studio β Generate stunning professional headshots with text prompts. Includes options for advanced
Aspect Ratiotuning and tiered Resolutions (1K, 2K, 4K) tied directly to a flexible credit cost system. - Multi-Image Reference Mode β Transition smoothly to professional editing. Upload local images or add external URLs to use as visual nodes for complex portrait configurations.
- Secure My Headshots Archive β A dedicated history vault for logged-in users. Displays past portrait sessions securely fetched from the database, viewable in a detailed inspector modal with 1-click downloads.
- Booking Tiers & Billing β Complete Stripe integration. Start users off with a balance, map generations to credit deductions, and seamlessly route them to an interactive pricing page to book sessions (Starter, Professional, Executive).
- Beautiful & Dynamic UI β Built on Tailwind CSS and Framer Motion, ensuring every state transition, loading spinner, and dropdown elegantly guides the user.
β‘ Deployment: Vercel & Production
Deploying an instance of AI Headshot Generator to the web requires minimal configuration. The architecture is engineered explicitly for Vercel serverless environments.
π Required Environment Variables
To successfully deploy and run, you must populate the following environment variables in your Vercel project settings:
| Service | Variable | Description & Source |
|---|---|---|
| Database | DATABASE_URL | PostgreSQL connection string (Supabase or Neon) |
DIRECT_URL | Direct DB connection for Prisma migrations | |
| NextAuth / Google | NEXTAUTH_SECRET | Secure random string generated via openssl rand -base64 32 |
NEXTAUTH_URL | Your production domain (e.g. https://my-app.vercel.app) | |
GOOGLE_CLIENT_ID | Get from Google Cloud Console | |
GOOGLE_CLIENT_SECRET | Get from Google Cloud Console | |
| Stripe Billing | STRIPE_SECRET_KEY | Get from Stripe Dashboard |
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY | Get from Stripe Dashboard | |
STRIPE_WEBHOOK_SECRET | Webhook secret for resolving credit purchases | |
| AI Generator | HEADSHOT_API_KEY | Create an account and get your API key for your targeted headshot model. |
π οΈ Local Development
Ready to iterate locally? Setup is straightforward.
Prerequisites
- Node.js (v18 or higher)
- A local PostgreSQL instance or a free cloud Database URL.
Setup
# 1. Clone the repository
git clone https://github.com/SamurAIGPT/ai-headshot-generator
cd ai-headshot-generator
# 2. Install dependencies
npm install
# 3. Setup Environment
cp .env.example .env
# Open .env and insert your specific keys.
# 4. Initialize Database Schema
npx prisma generate
npx prisma db push
# 5. Start the Development Server
npm run dev
The graphical console should now be heavily responsive on http://localhost:3000.
AI Headshot Generator: A modular, mobile-ready, production-grade AI portrait workspace built for creators and builders.
Similar repos
Contributors
13 commits
5 commits
Languages
JavaScript
95.2%
CSS
4.5%