Skip to content

Score!

We are Score a crazy ai engine for crowds and narration!

Code Video Cerebral Valley

Core trick

Gemini scores each tic-tac-toe move's intensity in real time and feeds it to browser speech synthesis as live commentary over Socket.IO.

Tags

voicecreative/music

Description

We are Score a crazy ai engine for crowds and narration! https://clever-gratitude-production.up.railway.app/
Banbanaste/score★ 00 forksTypeScriptCreated Feb 28, 2026 · last push Feb 28, 2026

README excerpt

# SCORE IS LIVE CHECK OUT THE WEBSITE!

https://clever-gratitude-production.up.railway.app/

Real-time multiplayer Tic-Tac-Toe with AI-powered intensity scoring, per-player morale tracking, and FIFA-style live commentary. Best-of-5 series format where tension compounds across rounds.

## Tech Stack

| Layer | Technology | Version |
|-------|-----------|---------|
| Runtime | Node.js | 20+ |
| Framework | Next.js | 16.1.6 |
| Frontend | React | 19 |
| Styling | Tailwind CSS | 4.x |
| WebSocket | Socket.IO | 4.8.3 |
| AI Inference | Google Gemini | `@google/genai` (gemini-2.5-flash-lite) |
| TTS | Web Speech API | Native browser |
| Language | TypeScript | 5.x |

---

## Quick Start

### Prerequisites

- Node.js 20+
- pnpm
- A [Google AI Studio](https://aistudio.google.com/apikey) API key (free tier)

### Setup

```bash
# Clone and install
git clone <repo-url>
cd retro-space
pnpm install

# Configure environment
cp .env.example .env   # or create .env manually
```

Add your Gemini API key to `.env`:

```env
GEMINI_API_KEY=your_key_here
```

### Run

```bash
# Development (custom server with Socket.IO + Next.js hot reload)
pnpm dev

# Open two browser tabs to http://localhost:3000
# Tab 1: Create Room -> copy room code
# Tab 2: Join Room -> paste code
```

### Build & Deploy

```bash
# Build (Next.js client + compiled server)
pnpm build

# Production
pnpm start
```

---

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|--

Team