Skip to content

How to run locally

Jump to bottom
Dominique Devereaux edited this page Aug 11, 2026 · 1 revision

How to run locally

Prerequisites

  • Node.js 18+
  • A Gemini API key (get one at aistudio.google.com)
  • A Bluesky app password (optional — only needed if running the Rift bot)

Setup

git clone https://github.com/Loptr-Lab/duet-solo-hackathon.git
cd duet-solo-hackathon
npm install
cp .env.example .env

Open .env and fill in your GEMINI_API_KEY.

Run

npm start

App runs at http://localhost:3000

Remote play

Remote play uses Socket.io rooms. Two browser tabs on localhost will connect to each other — no extra config needed for local testing.

Clone this wiki locally