This repository has been archived on 2026-02-01. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
synthetic-consumer-data/README.md

65 lines
1.6 KiB
Markdown

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