identityforge-cli 1.0.0

Developer-friendly toolkit for generating synthetic identities via CLI, Python, and REST API.

IdentityForge

A developer-friendly API & CLI for generating synthetic identities
Built for testing, mock data, privacy-focused workflows, and OPSEC training.

Features • Quick Start • Example • Feedback • License

📖 Overview

IdentityForge is an open-source toolkit for generating realistic synthetic identities for development, testing, automation, cybersecurity labs, privacy-focused workflows, demonstrations, and OPSEC training.

Unlike traditional identity generators, IdentityForge provides three different ways to access the same service, allowing developers to integrate it into any workflow:

• 💻 Command Line Interface (CLI)
• 🐍 Python Module
• 🌐 REST API

Whether you're writing automation scripts, testing applications, building demos, or experimenting with APIs, IdentityForge offers a simple and consistent developer experience.

---

✨ Features

• 🌍 Generate realistic synthetic identities for multiple countries
• ⚡ Fast REST API
• 💻 Cross-platform Command Line Interface (CLI)
• 🐍 Python package support
• 📦 Easy installation
• ☁️ Powered by Cloudflare Workers
• 📚 Comprehensive documentation
• 🔒 Uses synthetic data only

---

🚀 Installation

IdentityForge can be used in multiple ways depending on your workflow.

Option 1 — Install from GitHub (Recommended)

Clone the repository and install IdentityForge locally.

git clone https://github.com/Ad-i7ya/Identity-Forge.git
cd Identity-Forge
pip install -r requirements.txt
pip install -e .

After installation, verify that the CLI is available:

identityforge --help

List all supported countries:

identityforge countries

Generate a synthetic identity:

identityforge generate us

---

Option 2 — Install from PyPI

Coming Soon

After the first public release:

pip install identityforge

Verify the installation:

identityforge --help

List all supported countries:

identityforge countries

Generate a synthetic identity:

identityforge generate us

---

🐍 Option 3 — Python Module

IdentityForge can also be used directly inside your Python applications.

Import the package:

from identityforge import get_countries, generate_identity

List all supported countries:

from identityforge import get_countries

countries = get_countries()
print(countries)

Generate a synthetic identity:

from identityforge import generate_identity

identity = generate_identity("us")
print(identity)

Note

Before PyPI release, install the package locally using:

pip install -e .

After publishing to PyPI, simply run:

pip install identityforge

---

🌐 Option 4 — REST API

Use IdentityForge directly through HTTP requests.

Base URL

https://identity-forge.adi7ya.workers.dev

Available Endpoints

Method	Endpoint	Description
GET	/	API information
GET	/countries	List supported countries
GET	/generate?country=<code>	Generate a synthetic identity

Example Request

GET /generate?country=us

---

🧬 Example Response

{
  "success": true,
  "data": [
    {
      "Full Name": "Michael Walker",
      "Gender": "Female",
      "Birthday": "1967-08-08",
      "Age": 55,
      "Email": "[e-mail]",
      "Phone Number": "[phone]",
      "Country": "United States",
      "Country Code": "US",
      "Country Flag": "https://flagcdn.com/w320/us.png",
      "Flag Emoji": "🇺🇸",
      "State": "Illinois",
      "City": "West Elizabethton",
      "Street": "979 Kyle Well Apt. 289",
      "Pin Code": "56292",
      "Time Zone": "UTC-05:00",
      "Currency": "US Dollar (USD) - $",
      "Blood Group": "B+"
    }
  ],
  "metadata": {
    "version": "1.0.0"
  }
}

---

📚 Documentation

Additional documentation is available in the repository.

• 📖 CLI Guide: docs/cli.md
• 🌐 API Documentation: docs/api.md
• 💡 cURL Examples: examples/curl.md

---

🤝 Feedback

If you find IdentityForge useful:

• ⭐ Star the repository
• 🍴 Fork the project
• 🐞 Report bugs by opening an Issue
• 💡 Suggest new features or improvements

Contributions and constructive feedback are always welcome.

---

📄 License

This project is licensed under the MIT License.

See the LICENSE file for more information.