# Purchases Personas Generator

A TypeScript application that leverages the Anthropic Claude API to generate realistic fictional personas and their weekly purchase behaviors. For creating synthetic datasets for retail/e-commerce applications with believable user behaviors and spending patterns.

## 🌟 Features

- Generate detailed fictional personas including:
  - Personal 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 persona profiles
- Store generated data in:
  - PostgreSQL database for structured querying
  - JSON files for easy data portability

## 🚀 Getting Started

1. Install dependencies:

```bash
yarn install
```

2. Set up your environment variables:

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

3. Initialize the database:

```bash
yarn migrate
```

4. 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 generate` - Generate Prisma client
- `yarn migrate` - Run database migrations

## ⚠️ Disclaimer

The personas 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.