Modern CLI, beautiful HTML profiles, profile pictures, and instant QR/vCard export—all in one tool.

• ⚡ Ultra-modern CLI with rich, colored output and hacker aesthetics

• 🧑‍💻 Comprehensive Identity Generation

  • Personal details (name, age, gender, address, contact info)
  • Professional information (job, company, salary, industry)
  • Financial data (credit cards, PayPal, account balances)
  • Security credentials (SSN, passport, driver's license)
  • Digital footprint (browser, IP, timezone, user agent)
  • Interests, favorites, and personality traits

• 🖼️ Profile Picture Generation - Automatic avatar creation with DiceBear API

• 💳 Auto-generated Financial & Security Info

  • Realistic credit card numbers (Luhn-valid)
  • SSN, passport, driver's license numbers
  • PayPal accounts and transaction IDs

• 📱 Multiple Export Formats

  • vCard (VCF) - Import directly to contacts
  • QR Code - Scan to import contact
  • HTML Profile - Beautiful, mobile-friendly dossier
  • JSON/CSV/TXT - Structured data formats

• 🌐 Beautiful HTML Profiles

  • Modern hacker-themed design
  • Copy-to-clipboard functionality
  • Responsive mobile layout
  • Integrated QR codes and profile pictures

• 🔒 Privacy-First

  • No real data used
  • Safe for demos, OSINT, and red teaming
  • Ethical use only

graph TB
    A[User Command] --> B{Parse Arguments}
    B -->|Generate| C[Person Class]
    B -->|Help/About| D[Display Info]
    
    C --> E[Web Scraping]
    E -->|fakepersongenerator.com| F[Data Extraction]
    F --> G[Gender Detection]
    G --> H[Data Validation]
    H --> I[Generate Missing Fields]
    
    I --> J{Profile Picture?}
    J -->|Yes| K[DiceBear API]
    J -->|No| L[Skip Picture]
    
    K --> M[Export Module]
    L --> M
    
    M --> N[HTML Profile]
    M --> O[vCard Export]
    M --> P[QR Code]
    M --> Q[Data Files]
    
    N --> R[Output Directory]
    O --> R
    P --> R
    Q --> R
    
    style A fill:#39ff14,stroke:#00ffe7,stroke-width:2px
    style C fill:#00ffe7,stroke:#39ff14,stroke-width:2px
    style M fill:#39ff14,stroke:#00ffe7,stroke-width:2px
    style R fill:#00ffe7,stroke:#39ff14,stroke-width:2px

graph LR
    A[scayid.py<br/>Main CLI] --> B[core/simple.py<br/>Person & Generation]
    A --> C[core/colours.py<br/>ANSI Colors]
    A --> D[core/social_media.py<br/>Social Features]
    
    B --> E[Web Scraping]
    B --> F[Data Export]
    B --> G[Profile Pictures]
    
    F --> H[HTML Generator]
    F --> I[vCard Generator]
    F --> J[QR Code Generator]
    
    K[External APIs] --> E
    K --> G
    
    style A fill:#39ff14,stroke:#00ffe7,stroke-width:3px
    style B fill:#00ffe7,stroke:#39ff14,stroke-width:2px
    style F fill:#39ff14,stroke:#00ffe7,stroke-width:2px

sequenceDiagram
    participant U as User
    participant C as CLI (scayid.py)
    participant P as Person Class
    participant W as Web Scraper
    participant G as Generator
    participant E as Exporter
    
    U->>C: Execute Command (-g/-p)
    C->>P: Initialize Person()
    P->>W: Fetch from API
    W-->>P: Raw HTML Data
    P->>P: Parse & Extract Fields
    P->>P: Validate Gender/Nationality
    P->>G: Generate Missing Data
    G-->>P: Complete Person Object
    P->>E: Export to Formats
    E->>E: Generate HTML Profile
    E->>E: Create vCard File
    E->>E: Generate QR Code
    E->>E: Save Data Files
    E-->>U: Output Directory Created

• Python 3.8 or higher
• pip (Python package manager)
• Internet connection (for data fetching)

# Clone the repository
git clone https://github.com/Scayar/scayid.git
cd scayid

# Install dependencies
pip install -r requirements.txt

# Run Scayid
python scayid.py -g

# Using Python module
python -m scayid -g

# Or make it executable
chmod +x scayid.py
./scayid.py -g

python scayid.py -g

python scayid.py -p

# Generate with specific profession
python scayid.py -g -r "Cybersecurity Engineer" --gender male -n US

# Generate with picture and custom nationality
python scayid.py -p -n "United States" --gender female

# JSON format
python scayid.py -g -f json

# CSV format
python scayid.py -g -f csv

# Text format (default)
python scayid.py -g -f txt

python scayid.py -a      # Show about information
python scayid.py -b      # Display banner
python scayid.py -h      # Show help
python scayid.py -x      # Hack mode (fun animation)

After generation, a directory is created with the person's name containing:

PersonName/
├── PersonName.html          # Beautiful HTML profile
├── PersonName.vcf           # vCard for contact import
├── PersonName_qr.png        # QR code for scanning
├── PersonName_profile.png   # Profile picture (if -p used)
├── PersonName.json          # JSON data (if -f json)
├── PersonName.csv           # CSV data (if -f csv)
└── PersonName.txt           # Text data (if -f txt)

1. Import to Contacts: Open the .vcf file or scan the QR code with your phone
2. View HTML Profile: Open PersonName.html in any web browser
3. Use in Projects: Import JSON/CSV files for automation or testing

• requests - HTTP library for web scraping
• beautifulsoup4 - HTML parsing
• rich - Modern terminal output
• qrcode - QR code generation
• gender-guesser - Gender detection from names
• Pillow - Image processing (for QR codes)

Scayid supports generation for various nationalities. Common options include:

• US, UK, CA, AU, DE, FR, IT, ES, and many more
• Use -n flag with country code or full name

• Primary: fakepersongenerator.com (web scraping)
• Profile Pictures: DiceBear API (avatar generation)
• All data is synthetic and randomly generated

Contributions are welcome! Please feel free to submit a Pull Request.

# Clone the repository
git clone https://github.com/Scayar/scayid.git
cd scayid

# Create virtual environment (recommended)
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements.txt

# Make your changes and test
python scayid.py -g

• Follow PEP 8 guidelines
• Use meaningful variable names
• Add comments for complex logic
• Maintain the hacker aesthetic in UI

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Scayid is for educational, research, and legitimate red teaming purposes only.

• ✅ Allowed Uses:

  • Educational demonstrations
  • Security research and testing
  • Red team exercises (with authorization)
  • Software testing and development
  • Privacy protection demonstrations

• ❌ Prohibited Uses:

  • Identity fraud or impersonation
  • Financial fraud or scams
  • Harassment or stalking
  • Any illegal activities
  • Violation of platform terms of service

The authors and contributors are not responsible for misuse of this tool.

• Advanced profile picture customization
• Batch identity generation
• Database export/import
• API endpoint for programmatic access
• Additional export formats (XML, YAML)
• Custom template support
• Social media profile integration (experimental)

If you find this project useful, please consider:

• ⭐ Starring this repository
• 🐛 Reporting bugs or suggesting features
• 💬 Sharing with others who might find it useful
• ☕ Buying me a coffee if you're feeling generous