kabumon

README excerpt

# KABUKKA MONSTER (KABUMON)

**Raise your stocks. Conquer the market.**

A stock battle game powered by real market data and AI. Build a deck from real Japanese growth stocks, play event cards to shift the market, and watch AI narrate every move live.

---

## Features

- **Real-time stock prices** -- Fetched from Yahoo Finance via yfinance. Every session uses today's actual market prices
- **AI live commentary** -- Gemini 2.0 Flash generates unique turn-by-turn play-by-play and post-battle analysis for every match
- **Deck building** -- Pick 3 stocks from 10 real companies across 6 sectors (SaaS, Semiconductor, Gaming, Healthcare, AI/IT, IT)
- **Event cards** -- 5 market events (Bullish / Bearish / Neutral) that shift stock prices by sector
- **YouTube Live-style UI** -- Battle arena on the left, live chat commentary feed on the right. Profit/loss bars grow from characters after each sell

---

## Getting Started

### Prerequisites

- Node.js 18+
- Python 3.10+
- Gemini API key

### Setup

```bash
# Install Node dependencies
npm install

# Create Python virtual environment and install yfinance
python3 -m venv .venv
source .venv/bin/activate
pip install yfinance

# Set up environment variables
cp .env.local.example .env.local
# Edit .env.local and add your GEMINI_API_KEY
```

### Run

```bash
npm run dev
```

Open http://localhost:3000

---

## Environment Variables

| Variable | Description |
|---|---|
| `GEMINI_API_KEY` | Google Gemini API key for AI commentary |

Create a