# Synthetic Consumers Data Generator

A NextJS application that makes use of Anthropic models via Vercel AI Gateway 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:

```bash
yarn install
```

2. Set up your environment variables:

```bash
cp .env.example .env
```

3. Build and start the application:

```bash
yarn build
yarn start
```

For development:

```bash
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

## ⚠️ 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.