{"id":50618781,"url":"https://github.com/SamurAIGPT/ai-headshot-generator","last_synced_at":"2026-06-23T04:01:12.149Z","repository":{"id":351710964,"uuid":"1211525105","full_name":"SamurAIGPT/ai-headshot-generator","owner":"SamurAIGPT","description":"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.","archived":false,"fork":false,"pushed_at":"2026-06-02T18:56:38.000Z","size":113,"stargazers_count":18,"open_issues_count":0,"forks_count":10,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T20:24:44.757Z","etag":null,"topics":["ai-headshot-generator","ai-headshots","ai-image-generator","ai-photo-generator","ai-portrait","ai-saas","generative-ai","headshot-generator","linkedin-headshot","linkedin-photo","nextauth","nextjs","nextjs-boilerplate","portrait-generator","prisma","professional-headshots","profile-picture-generator","saas-boilerplate","stripe","tailwindcss"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SamurAIGPT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-15T13:32:01.000Z","updated_at":"2026-06-02T18:56:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SamurAIGPT/ai-headshot-generator","commit_stats":null,"previous_names":["samuraigpt/ai-headshot-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SamurAIGPT/ai-headshot-generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamurAIGPT%2Fai-headshot-generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamurAIGPT%2Fai-headshot-generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamurAIGPT%2Fai-headshot-generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamurAIGPT%2Fai-headshot-generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SamurAIGPT","download_url":"https://codeload.github.com/SamurAIGPT/ai-headshot-generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SamurAIGPT%2Fai-headshot-generator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34674702,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-headshot-generator","ai-headshots","ai-image-generator","ai-photo-generator","ai-portrait","ai-saas","generative-ai","headshot-generator","linkedin-headshot","linkedin-photo","nextauth","nextjs","nextjs-boilerplate","portrait-generator","prisma","professional-headshots","profile-picture-generator","saas-boilerplate","stripe","tailwindcss"],"created_at":"2026-06-06T09:00:22.084Z","updated_at":"2026-06-23T04:01:12.144Z","avatar_url":"https://github.com/SamurAIGPT.png","language":"JavaScript","funding_links":[],"categories":["Related Projects"],"sub_categories":[],"readme":"# 🚀 AI Headshot Generator — Professional Portrait Studio\n\n\u003e **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.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/Anil-matcha/awesome-generative-ai-apps\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Part%20of-Awesome%20Generative%20AI%20Apps-FFD700?style=for-the-badge\u0026logo=github\u0026logoColor=black\" alt=\"Awesome Generative AI Apps\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e 🎨 **[Explore 50+ more open-source AI apps →](https://github.com/Anil-matcha/awesome-generative-ai-apps)**\n\n## Related Projects\n\n- [Awesome-GPT-Image-2-API-Prompts](https://github.com/Anil-matcha/Awesome-GPT-Image-2-API-Prompts) — Curated GPT-Image-2 prompts including headshot styles\n- [Open-Generative-AI](https://github.com/Anil-matcha/Open-Generative-AI) — Free self-hosted studio with 200+ image models\n\n## 🌐 Live Manifestation\n\n**[Experience the full glassmorphic, responsive interface here](https://ai-headshot-generator-xi.vercel.app/)**. Sign in with Google to explore the Portrait Studio, My Headshots archive, and Booking Tiers directly from your browser.\n\n---\n\n**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 \u0026 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.\n\n**Why use AI Headshot Generator?**\n\n- **Production-Ready SaaS** — Complete with Google OAuth and Stripe Checkout workflows built-in.\n- **Dedicated Portrait Studio** — Specifically tailored UI for multi-image reference generation and professional style selection.\n- **Historical Archive** — All creations are securely persisted to a PostgreSQL database for a customized user gallery.\n- **Premium Glassmorphic UX** — Dynamic multi-theme support (Indigo, Emerald, Rose, Amber) with high-fidelity micro-animations.\n- **Extensible Architecture** — Easily swap out the underlying AI model while maintaining the premium application UI.\n\n![AI Headshot Generator](https://cdn.muapi.ai/outputs/d9c39378f60e48098f6b6ce657dc18b5.png)\n\n## ✨ Core Features\n\n- **Kinetic Portrait Studio** — Generate stunning professional headshots with text prompts. Includes options for advanced `Aspect Ratio` tuning and tiered Resolutions (1K, 2K, 4K) tied directly to a flexible credit cost system.\n- **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.\n- **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.\n- **Booking Tiers \u0026 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).\n- **Beautiful \u0026 Dynamic UI** — Built on Tailwind CSS and Framer Motion, ensuring every state transition, loading spinner, and dropdown elegantly guides the user.\n\n---\n\n## ⚡ Deployment: Vercel \u0026 Production\n\nDeploying an instance of AI Headshot Generator to the web requires minimal configuration. The architecture is engineered explicitly for **Vercel** serverless environments.\n\n### 🔑 Required Environment Variables\n\nTo successfully deploy and run, you must populate the following environment variables in your Vercel project settings:\n\n| Service               | Variable                             | Description \u0026 Source                                                                         |\n| :-------------------- | :----------------------------------- | :------------------------------------------------------------------------------------------- |\n| **Database**          | `DATABASE_URL`                       | PostgreSQL connection string ([Supabase](https://supabase.com) or [Neon](https://neon.tech)) |\n|                       | `DIRECT_URL`                         | Direct DB connection for Prisma migrations                                                   |\n| **NextAuth / Google** | `NEXTAUTH_SECRET`                    | Secure random string generated via `openssl rand -base64 32`                                 |\n|                       | `NEXTAUTH_URL`                       | Your production domain (e.g. `https://my-app.vercel.app`)                                    |\n|                       | `GOOGLE_CLIENT_ID`                   | Get from [Google Cloud Console](https://console.cloud.google.com/apis/credentials)           |\n|                       | `GOOGLE_CLIENT_SECRET`               | Get from [Google Cloud Console](https://console.cloud.google.com/apis/credentials)           |\n| **Stripe Billing**    | `STRIPE_SECRET_KEY`                  | Get from [Stripe Dashboard](https://dashboard.stripe.com/apikeys)                            |\n|                       | `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY` | Get from [Stripe Dashboard](https://dashboard.stripe.com/apikeys)                            |\n|                       | `STRIPE_WEBHOOK_SECRET`              | Webhook secret for resolving credit purchases                                                |\n| **AI Generator**      | `HEADSHOT_API_KEY`                   | Create an account and get your API key for your targeted headshot model.                     |\n\n---\n\n## 🛠️ Local Development\n\nReady to iterate locally? Setup is straightforward.\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/en/) (v18 or higher)\n- A local PostgreSQL instance or a free cloud Database URL.\n\n### Setup\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/SamurAIGPT/ai-headshot-generator\ncd ai-headshot-generator\n\n# 2. Install dependencies\nnpm install\n\n# 3. Setup Environment\ncp .env.example .env\n# Open .env and insert your specific keys.\n\n# 4. Initialize Database Schema\nnpx prisma generate\nnpx prisma db push\n\n# 5. Start the Development Server\nnpm run dev\n```\n\nThe graphical console should now be heavily responsive on `http://localhost:3000`.\n\n---\n\n_AI Headshot Generator: A modular, mobile-ready, production-grade AI portrait workspace built for creators and builders._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSamurAIGPT%2Fai-headshot-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSamurAIGPT%2Fai-headshot-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSamurAIGPT%2Fai-headshot-generator/lists"}