synthetic-consumer-data/README.md

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:

yarn install

2. Set up your environment variables:

cp .env.example .env

3. Initialize the database:

yarn migrate

4. 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 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.