Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/riccardosenica/purchases-personas

Generate realistic fictional personas and their weekly purchase behaviors using AI. Create synthetic consumer datasets with detailed profiles, shopping habits, and consistent spending patterns.
https://github.com/riccardosenica/purchases-personas

ai-generation anthropic claude-api synthetic-data typescript

Last synced: 2 months ago
JSON representation

Generate realistic fictional personas and their weekly purchase behaviors using AI. Create synthetic consumer datasets with detailed profiles, shopping habits, and consistent spending patterns.

Awesome Lists containing this project

README

        

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