Made for Bearhacks 2026 — nintendo plz don't sue ありがとうございます

PokeFood turns your food photos into Pokémon-style creatures and lets you battle them against a friend in real time. Snap a picture of your meal, watch it get classified and transformed into a unique fighter with its own type, HP, and moves, then challenge another player to a WebSocket-powered battle.

• 📸 Food-to-Fighter: Upload or snap a photo of any food item; the ML backend classifies it and generates a unique "pokefood" with a name, type, HP, and moves.
• 🗂️ Collection: Each user account stores their own pokefood roster — collect as many as you eat.
• ⚔️ Real-time Battles: Two players join the same battle room over WebSockets and take turns attacking until one pokefood faints.
• 🔐 Auth: JWT-based registration & login. Two demo accounts (test1@example.com / test2@example.com, password secret123) are seeded automatically on first run.

• uv — Python package manager used by the backend
• Node.js / npm — used by the frontend

cd frontend
npm install
cd ..

cp backend/.env.example backend/.env   # then fill in your OPENAI_API_KEY

./dev.sh

This single script starts:

• Backend on http://127.0.0.1:8000 (FastAPI/uvicorn, auto-reload)
• Frontend on http://localhost:5173 (Vite dev server)

Press Ctrl+C to stop both servers.

WebSocket battles require both players to reach the same backend. When playing across two different machines you need to expose your local backend over the internet with a tunneling service.

# In a separate terminal, after ./dev.sh is running
ngrok http 8000

ngrok will print a public URL such as https://abc123.ngrok-free.app. Share that URL with your opponent and make sure the frontend points to it (set VITE_API_URL in frontend/.env or update src/constants.ts).

npx localtunnel --port 8000

If both players are on the same network you can simply use your local IP address (e.g. http://192.168.x.x:8000) without any tunnel.

pokefood/
├── dev.sh            # One-command dev launcher
├── frontend/         # React + Vite app
│   └── src/
│       ├── screens/  # LoginScreen, RegisterScreen, HomeScreen, BattleScreen
│       └── ...
└── backend/
    ├── app/
    │   ├── api/      # REST endpoints (auth, pokefoods)
    │   ├── ws/       # WebSocket battle rooms
    │   ├── services/ # ML & game logic
    │   └── db/       # SQLAlchemy models & session
    └── ml/           # Food classification helpers

Interactive API docs are available at http://127.0.0.1:8000/docs while the backend is running.

refer to patent: https://archive.org/details/12403397/page/n7/mode/2up