🆔✨ Ceylon NIC Engine 🇱🇰

🧪 A playful, AI-infused, barcode-generating, identity-fabricating engine made for Sri Lankan devs, designers & testers 🇱🇰!

---

🚀 What is this?

Ceylon NIC Engine is a web app that lets you generate fake but realistic Sri Lankan National ID Card data (NICs) for fun, learning, and testing.

It combines:

• 🎲 Random Sinhala names
• 📍 Smart addresses
• 🧠 Gemini AI-powered portraits
• 📇 PDF417 barcodes

With a modern UI and super chill vibes 🌈

---

🧰 Features

• 🆔 Generates NICs that look real (but aren't!)
• 👦 Sinhala name/person generation (Tamil & Muslim coming soon)
• 🏡 Address & location data included
• 📸 Portraits made by Gemini AI
• 📇 PDF417 barcode matches the NIC data
• 🌗 Beautiful dark-orange UI (TailwindCSS)
• ⚙️ Built with Flask (soon Gunicorn)

---

📸 Demo Preview

---

🧠 AI + Barcode Sync

📇 Barcode = Truth.
The PDF417 barcode is encoded with the same exact data as shown on the NIC:

• Full Name (Sinhala/Tamil/English)
• DOB
• Gender
• Province
• NIC Number

📌 The PDF417 barcode is 100% encoded with the exact generated data for the fake identity.
If someone scans the barcode, the data on the front side of the ID card will match the decoded barcode content exactly.

---

📁 Project Structure

Ceylon-NIC-Engine/
├── run.py                      # Main Flask app entry point
├── requirements.txt            # Python dependencies
├── .env                        # Gemini API key (NOT version-controlled)
├── LICENSE                     # MIT License
├── templates/
│   └── index.html              # Main HTML template
├── static/
│   └── portrait/
│       └── temp.jpg            # Cached portrait image
├── gendata/                    # Go microservice source (NIC generator)
│   ├── build_all.ps1           # Build script for Windows
│   ├── build_all.sh            # Build script for Linux/macOS
│   ├── go.mod                  # Go module definition
│   ├── go.sum                  # Go module checksums
│   └── nic_generator.go        # Go source for NIC data logic
├── bin/                        # Precompiled Go binaries
│   ├── amd64_linux_NICServer
│   ├── amd64_windows_NICServer.exe
│   ├── amd64_darwin_NICServer
│   ├── arm64_linux_NICServer
│   └── arm64_darwin_NICServer
├── generated/                  # Saved fake NIC generations
│   └── 200151092876/
│       ├── barcode.png
│       ├── portrait.jpg
│       └── data.txt
├── downloads/                  # Exported NIC zip archives
│   └── 200151092876-234045-2662025.zip
├── logs/                       # Logs for debugging AI responses
│   ├── last_name_response.json
│   └── last_address_response.json
├── img/                        # Assets for README/demo purposes
│   ├── demoscreenshot.png
│   └── Untitled-ASDs2.png

---

---

🚀 Getting Started

🔧 Requirements

• Python 3.8+
• Go (for the NIC generator microservice) Download GoLang from here
• Gemini API Key from Google AI Studio

🔑 Get Your Gemini API Key

1. Go to https://aistudio.google.com/
2. Sign in with your Google account.
3. Click your profile pic (top right) → API Keys
4. Click Create API Key and copy it.

Create or update .env file in the root folder and paste/change this:

GEMINI_API_KEY=your_google_gemini_api_key

Replace "your_google_gemini_api_key" with your actual API Key. And KEEP YOUR KEY SAFE.

---

💻 Installation

git clone https://github.com/ChocoJaYY/Ceylon-NIC-Engine.git
cd Ceylon-NIC-Engine
python3 -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
pip install -r requirements.txt

---

⚙️ Build Go Backend (Optional)

Make sure you have Go installed and in your PATH.

For Linux/macOS:

cd gendata
bash build_all.sh

For Windows:

cd gendata
.build_all.ps1

---

🧪 Run the App

source venv/bin/activate
python run.py

Then visit 👉 http://localhost:5000

---

📸 Example Output

Below are examples of the kind of data generated by this engine:

🆔 Sample NIC Output with Portrait and Barcode

📌 The PDF417 barcode is 100% encoded with the exact generated data for the fake identity.
If someone scans the barcode, the data on the front side of the ID card will match the decoded barcode content exactly.

---

📦 Tech Stack

Part	Tech
🎨 Frontend	HTML + TailwindCSS
🧠 AI Power	Gemini (Google AI)
🐍 Backend	Flask (Python)
⚙️ Microservice	Go + Gin
🖼️ Portraits	PIL + Gemini
📇 Barcode	pdf417 (Python library)

---

📝 TODO List

🚧 Future Features & Fixes in the Works:

• 🔥 Switch to Gunicorn instead of Flask dev server
• ♻️ Add a way to restore previous generations. (Maybe a admin panel or IDK)
• 🛡️ Fix directory traversal security issue (PLEASE NEVER DEPLOY THIS PUBLICLY. If you did so good luck)
• 🌍 Migrating all Gemini requests to requests instead of curl
• 🌐 Add Tamil & Muslim person generation (random or selectable)
• 🕒 NIC History View – track previously generated NICs
• ❌ Retry & better error handling for Gemini/API failures
• ✅ Input validation to harden the app
• 🎛️ Add Advanced Generation Mode (e.g. user defines skin tone, hair, background)
• 🚷 Prevent external API abuse (rate limits, tokens, CAPTCHA)
• 📁 Organize & sandbox file handling
• 👤 Add Local Mode and Public Mode. (Public mode If youre exposing this to public internet. More on later.)

---

🌟 Show Some Love

If you enjoy this project:

• ⭐ Star it
• 🐛 Report bugs
• 🧠 Suggest ideas
• 🔥 Fork it and go wild to makes me motivate to maintain, make new projects like these. 🧡

Made with 🧡 for Sri Lankans 🇱🇰
by @ChocoJaYY

---

📄 License

MIT License