AI-powered Product Requirements Document Generator with cross-platform GUI and CLI interfaces that creates detailed, AI-consumable documentation for projects ranging from simple landing pages to complex enterprise systems and full business ventures.

✅ Windows, macOS, Linux - Native GUI and CLI
✅ Automatic AI Setup - Claude Code via npm, Ollama support
✅ One-Click Bootstrap - Detects and sets up everything automatically
✅ Persistent Settings - Retains user preferences between sessions
✅ Standalone Executables - No Python installation required for end users

🎯 Adaptive Question Engine: Dynamic interview process that adapts questions based on product type, industry, and complexity level

📊 Comprehensive Coverage: Supports 10+ product types from landing pages to full business structures

🤖 AI-Ready Output: Generates machine-readable PRDs in multiple formats (Markdown, PDF, Text)

📈 Task Management: Built-in task tracking with unique identifiers, dependencies, and status management

💾 Session Management: Save, resume, and manage multiple PRD projects with SQLite storage

🏭 Industry-Specific: Specialized questions and compliance requirements for healthcare, finance, and other industries

• Landing Pages
• Mobile Apps (iOS/Android)
• Web Applications
• Desktop Applications
• SaaS Platforms
• Enterprise Software
• E-commerce Sites
• FinTech Products
• HealthTech Products
• Full Business/Startup Plans

Windows (Double-click):

1. Download/clone the repository
2. Double-click launch_prdy_gui.bat

macOS/Linux (Double-click):

1. Download/clone the repository
2. Double-click launch_prdy_gui.sh or run ./launch_prdy_gui.sh

Any Platform (Command line):

git clone https://github.com/jetrich/prdy.git
cd prdy
python3 launch_gui.py

Linux/macOS:

git clone https://github.com/jetrich/prdy.git
cd prdy
./setup.sh

Windows:

git clone https://github.com/jetrich/prdy.git
cd prdy
setup.bat

git clone https://github.com/jetrich/prdy.git
cd prdy

# Create and activate virtual environment
python3 -m venv prdy-env
source prdy-env/bin/activate  # On Windows: prdy-env\Scripts\activate

# Install dependencies and package
pip install -r requirements.txt
pip install -e .

Option 1: Using pipx (Isolated)

pipx install git+https://github.com/jetrich/prdy.git

Option 2: System-wide (Debian/Ubuntu)

git clone https://github.com/jetrich/prdy.git
cd prdy
pip install -r requirements.txt --break-system-packages
pip install -e . --break-system-packages

Option 3: Using uv (Fastest)

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt
uv pip install -e .

Issue: externally-managed-environment error on Debian/Ubuntu

# Solution 1: Use virtual environment (recommended)
python3 -m venv prdy-env
source prdy-env/bin/activate
pip install -r requirements.txt

# Solution 2: Use --break-system-packages flag
pip install -r requirements.txt --break-system-packages

# Solution 3: Use pipx for isolation
pipx install git+https://github.com/jetrich/prdy.git

Issue: Permission denied errors

# Use --user flag to install in user directory
pip install -r requirements.txt --user
pip install -e . --user

Issue: Missing Python development headers

# Ubuntu/Debian
sudo apt install python3-dev python3-venv

# CentOS/RHEL/Fedora  
sudo dnf install python3-devel python3-venv

# macOS (using Homebrew)
brew install python

Issue: Corrupted virtual environment

# Clean and reinstall
./clean.sh          # Remove old environment
./setup.sh          # Fresh installation

# Launch GUI directly
python3 launch_gui.py

# Or use command after setup
prdy-gui

prdy new

This will launch an interactive session where you'll:

1. Select your product type
2. Choose your industry
3. Set complexity level
4. Complete a comprehensive interview
5. Generate your PRD

prdy list

prdy status <session_id>

prdy export <session_id> <format>
# Formats: markdown, pdf, text

prdy interview <session_id>

prdy/
├── models/          # Data models and database schema
│   ├── prd.py      # Core PRD models
│   └── database.py # Database management
├── engines/         # Question and processing engines
│   └── question_engine.py # Dynamic question generation
├── utils/          # Business logic and services
│   └── prd_service.py # Core PRD operations
├── templates/      # PRD templates (future)
├── exporters/      # Export functionality (future)
├── gui.py         # Cross-platform GUI interface
└── cli.py         # Command line interface

• Unique Identifiers: All tasks have unique IDs (e.g., PRD-001-001)
• Dependency Tracking: Tasks can depend on other tasks
• Status Management: Track progress with pending/in-progress/completed/blocked
• Difficulty Assessment: Rate tasks from trivial to expert level
• Time Estimation: Track estimated vs actual hours

The system uses SQLite by default with two main tables:

• prd_sessions: Stores PRD project information and interview data
• tasks: Manages task tracking with relationships and dependencies

Create a .env file to customize settings:

DATABASE_URL=sqlite:///./prdy.db
# or use PostgreSQL:
# DATABASE_URL=postgresql://user:pass@localhost/prdy

Human-readable format with proper headings and structure

Professional document format using ReportLab

Plain text format for simple consumption

pip install -e ".[dev]"

pytest

black prd_generator/

mypy prd_generator/

• Integration with Claude Code for enhanced analysis
• Ollama support for local AI processing
• Automated gap analysis and suggestions

• React/NextJS web application
• Real-time collaboration
• Advanced visualization

• Team management
• Custom templates
• API integrations
• Advanced analytics

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

MIT License - see LICENSE file for details

For issues and feature requests, please use the GitHub issues tracker at https://github.com/jetrich/prdy/issues

Built with PRDY - AI-powered Product Requirements Document Generator