Quickstart
Get Higgsfield running locally in 5 minutes.
Prerequisites
- Bun >= 1.0
- A PostgreSQL database (Neon for serverless, or local)
- Stripe CLI (for webhook testing)
Setup
Clone the repository
git clone https://github.com/higgsfield-ai/higgsfield.git
cd higgsfieldInstall dependencies
bun installConfigure environment variables
Copy the root .env.example to .env and fill in the required values:
cp .env.example .envKey variables:
| Variable | Description |
|---|---|
DATABASE_URL | PostgreSQL connection string |
BETTER_AUTH_SECRET | Random secret (min 16 chars) |
BETTER_AUTH_URL | App base URL (e.g. http://localhost:3000) |
STRIPE_SECRET_KEY | Stripe API key |
RESEND_API_KEY | Resend email API key |
Push database schema
bun run db:pushStart all apps
bun run dev| App | URL |
|---|---|
| Main app | http://localhost:3000 |
| API server | http://localhost:3002 |
| Docs | http://localhost:3004 |