• Global Coverage - Generate users from 110+ countries worldwide
• Custom Filters - Generate users by gender, nationality, and quantity
• 5 Theme Options - Dark, Light, Red, Blue, and Green themes
• Responsive Design - Works seamlessly on all devices
• Fast & Modern - Built with performance in mind
• Live Updates - Real-time user generation
• Detailed Profiles - Complete user information including:
  • Name (Title, First, Last)
  • Contact (Email, Phone, Cell)
  • Location (Address, City, State, Country, Zip)
  • Personal (Age, Gender, DOB, Registration Date)
  • Identification (Username, ID documents)
  • Avatar with Initials

• Python 3.8 or higher
• pip package manager

1. Clone the repository

   git clone https://github.com/walterwhite-69/UserForge.git
   cd UserForge

2. Install dependencies

   pip install -r requirements.txt

3. Run the application

   python app.py

4. Open your browser

   http://localhost:5000
   

Generate random user profiles with optional filters powered by FakerAPI.it.

curl "http://localhost:5000/api/users?results=3&gender=female&nat=JP"

{
  "success": true,
  "count": 3,
  "users": [
    {
      "uuid": "eb338bc6-a747-4f3e-bfaf-79fecf7dee9e",
      "username": "tanaka_momoko710",
      "title": "Ms",
      "first_name": "舞",
      "last_name": "工藤",
      "gender": "female",
      "email": "[email protected]",
      "phone": "+995771098743",
      "cell": "+206409398401",
      "street_number": 105,
      "street_name": "田辺町",
      "city": "江古田市",
      "state": "江古田市",
      "country": "Japan",
      "postcode": "2103931",
      "nationality": "JP",
      "date_of_birth": "2021-11-18T00:00:00.000Z",
      "age": 3,
      "registered_date": "2019-11-29T15:10:21.000Z",
      "registered_age": 6,
      "picture_large": null,
      "picture_medium": null,
      "picture_thumbnail": null,
      "id_name": "National ID",
      "id_value": "889047757"
    }
  ]
}

import requests
import json

BASE_URL = "http://localhost:5000"

# Get 5 female users from Japan
response = requests.get(f"{BASE_URL}/api/users?results=5&nat=JP&gender=female")
data = response.json()

for user in data['users']:
    print(f"Name: {user['first_name']} {user['last_name']}")
    print(f"Email: {user['email']}")
    print(f"Location: {user['city']}, {user['country']}")
    print(f"Username: {user['username']}")
    print("-" * 50)

Name: 舞 工藤
Email: [email protected]
Location: 江古田市, Japan
Username: tanaka_momoko710
--------------------------------------------------
Name: 智実 中島
Email: [email protected]
Location: 江古田市, Japan
Username: yoko42652
--------------------------------------------------

// Fetch 3 female users from Germany
fetch('http://localhost:5000/api/users?results=3&gender=female&nat=DE')
  .then(response => response.json())
  .then(data => {
    data.users.forEach(user => {
      console.log(`${user.first_name} ${user.last_name}`);
      console.log(`Email: ${user.email}`);
      console.log(`Phone: ${user.phone}`);
      console.log(`---`);
    });
  })
  .catch(error => console.error('Error:', error));

UserForge includes 5 themes:

• Dark (default, with purple accents)
• Light (clean and minimal)
• Red (vibrant look)
• Blue (cool and soft)
• Green (fresh tone)

Click the theme toggle button in the header to switch themes.

1. Install Vercel CLI:

   npm install -g vercel

2. Deploy:

   vercel

1. Create a Heroku app:

   heroku create your-app-name

2. Push to Heroku:

   git push heroku main

1. Connect your GitHub repository to Railway
2. Set the start command: python app.py
3. Deploy!

UserForge/
├── static/
│   ├── index.html
│   ├── style.css
│   └── app.js
├── app.py
├── example_fetch.py
├── requirements.txt
├── vercel.json
└── README.md

• Backend: Flask (Python)
• Frontend: HTML5, CSS3, JavaScript
• API: FakerAPI.it
• Styling: Custom CSS Variables
• Deployment: Vercel, Heroku, Railway

• Development & Testing - Generate test user data for any country
• UI/UX Design - Populate designs with realistic global profiles
• Data Analysis - Create sample datasets from various locales
• Education - Learn API integration and JSON handling
• Internationalization - Test apps with multilingual user data

This project is licensed under the MIT License - see the LICENSE file for details.

Contributions are welcome!

1. Fork the project
2. Create a new branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Data: FakerAPI.it
• Inspiration: modern minimal web design

Have questions or want to collaborate?

• Discord: discord.gg/rgWcEw5G8a
• Discord Username: heisenburger_7