NFC Event Check-in 🎟️

Event registration and check-in system using NFC wristbands/tags.

Supports participant registration with photos, local data storage (CSV + photos), and scanning at the booth to display participant names and photos.

---

Requirements 📝

Hardware

• NFC reader (ACS ACR122U recommended)
• Webcam (to take photos during registration)

Required to install:

• Python 3.12+
• Node 22.18.0+
• ACS ACR122U NFC Reader Driver

Optional to install:

• Bun
• ACS QuicView for Utility

---

Get Started 🚀

1. Clone Repository

git clone https://github.com/aptrocode/Event-NFC-Reader.git

2. Go to the project folder

cd Event-NFC-Reader

3. Create and activate a Virtual Environment

python -m venv .venv

.\.venv\Scripts\activate

4. Install dependencies

pip install -r requirements.txt

5. Go to frontend folder

cd frontend

6. Install dependencies

bun install

Note

if not using bun just delete bun.lockb, and switch to another package manager like:

# npm install
# yarn install
# pnpm install

---

Usage 💻

Run development

bun dev

Note

Make sure you run the command in the /frontend directory

---

License

The code is licensed MIT