Built in the open, free forever
BioLoom is a fully open-source AI bio generator. No accounts, no paywalls, no rate limits. Clone it, customise it, deploy your own — takes under 10 minutes.
Groq + Gemini with automatic fallback chain
LinkedIn, Twitter/X, Instagram, GitHub, General
No database, no accounts, no tracking
No signup, no rate limits on the free tier
Tech Stack
Every dependency is free, open-source, and production-ready.
App Router, Server Components, Turbopack builds, and Edge Runtime for OG images.
End-to-end type safety across API routes, Zustand store, and all UI components.
Utility-first styling with custom animations, HSL design tokens, and responsive breakpoints.
Accessible, unstyled Radix primitives with copy-paste Tailwind components.
`streamObject` and `generateObject` with structured Zod schemas, streaming via ReadableStream.
Ultra-fast inference: Llama 3.1, Llama 3.3, Gemma 2, Mistral Saba, DeepSeek R1, Qwen QwQ.
Gemini 2.0 Flash as the final fallback — free tier with generous rate limits.
Minimal global store for generation state, history, UI flags, and persisted preferences.
Schema validation on both client form inputs and AI-generated structured outputs.
Serverless functions with 60s timeout, Edge OG images, Analytics, Speed Insights.
Architecture
No database required. Everything lives in the browser or serverless functions.
Browser
└── Next.js App Router (Server Components)
├── / → Home page (generator)
├── /about → This page
└── /api
├── /generate → streamObject → Groq / Gemini
├── /score → generateObject → LRU cache → Groq / Gemini
└── /health → Provider key check
State (client-only, no DB)
├── Zustand store → generation state, history, UI flags
└── localStorage → persisted preferences (model/tone/type)
AI Pipeline
Request → Model Registry → withRetry → [model, ...fallbacks]
└── streamObject (Vercel AI SDK v4)
Deployment
Vercel Hobby (free)
├── Edge Runtime → OG image generation
├── Serverless Functions → /api/* (60s timeout)
└── CDN → Cache-Control headers on /api/scoreDeploy Your Own — Free
From zero to a live app at your own URL in under 10 minutes.
100% free to run. Vercel Hobby plan has no cost. Groq and Google AI Studio both offer free tiers with generous limits (10,000+ requests/day).
Clone the repository
git clone https://github.com/zhenxiao-yu/ai-bio-generator.git
cd ai-bio-generator
npm installGet your free API keys
You need at least one of the following. Both are free:
- Groq→ Create account → API Keys → Create key
- Google AI Studio→ Get API key (free, no billing)
Create your environment file
# .env.local (never commit this file)
GROQ_API_KEY=gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
GOOGLE_GENERATIVE_AI_API_KEY=AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxx
# Optional: your custom domain once deployed
NEXT_PUBLIC_SITE_URL=https://your-app.vercel.appRun locally
npm run dev
# Open http://localhost:3000Deploy to Vercel (free)
Vercel's Hobby plan is permanently free and handles everything automatically.
# Option A — Vercel CLI
npm i -g vercel
vercel
# Option B — GitHub integration (recommended)
# 1. Push your fork to GitHub
# 2. Go to vercel.com → New Project → Import your repo
# 3. Add GROQ_API_KEY and GOOGLE_GENERATIVE_AI_API_KEY
# in Project Settings → Environment Variables
# 4. Click Deploy — done in ~60 secondsOptional: custom domain
In Vercel → Project → Settings → Domains, add your own domain. Point your DNS CNAME to cname.vercel-dns.com and Vercel handles SSL automatically.
# Add a custom domain in Vercel:
# 1. Vercel Dashboard → Your Project → Settings → Domains
# 2. Enter your domain (e.g. mybio.com or sub.mybio.com)
# 3. Add a CNAME record at your DNS provider:
# CNAME @ cname.vercel-dns.com
# 4. SSL certificate is issued automatically (~60s)Start generating bios
No account needed. Fill in a few details and get 4 platform-optimised bios in seconds.