ODDBOUT
English | 한국어
PayPal AI Hackathon entry: ODDBOUT Showrunner. Sponsors pay with PayPal, an AI producer
runs the show, and creators get paid. PayPal Sandbox only.
Demo video · Hosted demo ·
Judges' page · HACKATHON.md
Create a fighter with AI. Bring your character into the arena.
ODDBOUT is a fighting game where you play with a character you create. This repository contains the open-source tools for making that character. Work with an AI assistant to turn a description or reference image into artwork, animations, and a fighter package for the game. The tools and docs also use the name AI Fighter. It also holds ODDBOUT Showrunner, an experimental agent broadcast that runs ODDBOUT cups on a PayPal Sandbox budget.
Play ODDBOUT · Manage your fighters · Site guide · Creation guide · Report a problem
Quick start for agents
For a workspace agent (a Linux shell, an image generator, and the ODDBOUT connector):
git clone --branch main --single-branch https://github.com/jeonghwanko/oddbout-starter.gitcd oddbout-starter && npm ci --ignore-scripts- Generation only: install ffmpeg, then
npm run sprite:setup (submodule, venv, and RIFE, about 430 MB). Node.js 22.12 or newer.
npm run example && npm run validate -- output/sparring-bot/fighter.json- Profile set:
npm run fighter:profile-set -- --front <front with alpha> --out <new folder>
ChatGPT can register with host file attachments. A host without those file arguments cannot upload local WebP files through the connector. Run npm run login, then npm run fighter:register (dry run until --submit), or upload the finished package on the creator page. The account limit defaults to three fighters and follows that account's fighter_limit.
To change motions on a fighter that is already registered, submit a new package with that fighter's id. Do not use revise_hosted_motion for that. Details: docs/AGENT-QUICKSTART.md.
Connect your coding agent
In Claude Code, Codex or Gemini CLI, paste this one line:
Connect ODDBOUT: run npx -y oddbout@latest connect and follow what it prints.
Your agent adds ODDBOUT's hosted MCP (oddbout, https://mcp.oddbout.com/signin), you approve the Google sign-in once in your browser, and it installs the creation skill in Codex and Claude Code. In Claude Code you start that sign-in yourself: type /mcp, choose oddbout, then Authenticate (Claude Code signs in only from its own screen or a terminal). In the Claude desktop app, start a new session first and press Connect for oddbout in /mcp; if ODDBOUT refuses that sign-in, run claude mcp login oddbout in a terminal and start a new session. Then it checks your account with get_profile. It never asks for a token, and it keeps any ODDBOUT server you already have (how it works, the oddbout package). For claude.ai, ChatGPT or Grok in a browser, use My agents on the creator page instead.
The Codex skill alone, by hand: Codex installation guide. It adds the creation skill and reuses your existing ODDBOUT MCP. No directory approval or creator-kit ZIP is required.
Watch
ODDBOUT × Twitch Cup (2:50). Built by agents, picked by chat, fought live: a Codex agent connects to ODDBOUT's MCP and plugin, Dots draws and animates the fighters, oddbout.com checks and registers them, and Twitch viewers send them into a four-fighter cup by typing !join. The stream shown is a solo rehearsal.
Try the cup · Twitch Cup source
ODDBOUT Showrunner (2:45). An animated walkthrough of paid agent broadcast work that keeps going when a laptop closes, a payment tab never returns or a server restarts, so a payment is neither lost nor charged twice. The last minute is the live Sandbox site: a sponsor pays with PayPal, the AI producer runs the cups, PayPal MCP matches the order and PayPal Payouts pays the creators.
Try the PayPal Sandbox demo (test money only) · About Showrunner
Gameplay clip
Existing ODDBOUT gameplay. The subscription-based character creation workflow is still experimental; this clip does not show a complete creation run.
Watch the 10-second clip · Play ODDBOUT · Questions and feedback
This is the beginning of the README. Read the rest at the original. Read the full README ↗
