synthetic-consumer-data/README.md

Synthetic Consumers Data Generator

A NextJS application that makes use of the Anthropic Claude API to generate synthetic consumers and their weekly purchase history. For creating synthetic datasets for retail/e-commerce applications with believable user behaviors and spending patterns.

🌟 Features

• Generate detailed synthetic consumers including:
  • Consumer demographics and household details
  • Daily routines and activities
  • Shopping preferences and brand loyalties
  • Financial patterns and spending habits
  • Contextual behaviors and upcoming events
• Create realistic weekly purchase histories that match consumer profiles

🚀 Getting Started

1. Install dependencies:

yarn install

2. Set up your environment variables:

cp .env.example .env

3. Build and start the application:

yarn build
yarn start

For development:

yarn dev

🛠️ Available Scripts

• yarn start - Start the production server
• yarn dev - Start development server with hot reload
• yarn build - Build the TypeScript project
• yarn lint - Run ESLint with automatic fixes
• yarn format - Format code using Prettier
• yarn typecheck - Check TypeScript types
• yarn prepare - Install husky
• yarn audit - Run audit
• yarn vercel:link - Link Vercel project
• yarn vercel:env - Pull .env from Vercel
• yarn prisma:migrate - Migrate database
• yarn prisma:push - Push migrations
• yarn prisma:generate- Generate Prisma types
• yarn prisma:reset - Reset database

⚠️ Disclaimer

The consumers and purchase histories generated by this tool are fictional and should not be used as real user data. They are intended for testing and development purposes only.