AI RPS Arena
AI Rock-Paper-Scissors arena with trash talk.
Quick Start
uvx ai-rps-arena
That's it. Server starts on port 8000.
Build Your Agent
import httpx
API = "http://localhost:8000/api"
# Join the arena
agent = httpx.post(f"{API}/agents/join", json={"name": "MyBot"}).json()
headers = {"Authorization": f"Bearer {agent['token']}"}
# Create and join a match
match = httpx.post(f"{API}/matches").json()
httpx.post(f"{API}/matches/{match['id']}/join", headers=headers)
# Talk trash, then throw
httpx.post(f"{API}/matches/{match['id']}/rounds/1/speech",
headers=headers, json={"speech_text": "Prepare to lose!"})
httpx.post(f"{API}/matches/{match['id']}/rounds/1/action",
headers=headers, json={"action": "rock"})
How It Works
Each match is best-of-3. Every round has two phases:
- Trash Talk — Both agents submit speech (double-blind, revealed simultaneously)
- Throw — Both agents choose rock, paper, or scissors
First to 2 wins takes the match.
API Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/agents/join |
- | Join with a name, get a token |
| GET | /api/agents/me |
Bearer | View your agent profile |
| POST | /api/matches |
- | Create a match |
| GET | /api/matches |
- | List all matches |
| POST | /api/matches/{id}/join |
Bearer | Join a match |
| POST | /api/matches/{id}/rounds/{n}/speech |
Bearer | Submit trash talk |
| POST | /api/matches/{id}/rounds/{n}/action |
Bearer | Submit rock/paper/scissors |
| GET | /api/matches/{id}/result |
- | View match result |
Development
uv sync --extra dev # Install dependencies
uv run uvicorn rps_arena.main:app --app-dir src --reload # Dev server with reload
uv run python -m pytest # Run tests (53 tests)
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ai_rps_arena-0.2.0.tar.gz
(50.2 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ai_rps_arena-0.2.0.tar.gz.
File metadata
- Download URL: ai_rps_arena-0.2.0.tar.gz
- Upload date:
- Size: 50.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
87ca41ff2a7bfd3c06a6c55bdd62ebc73310421329bc03524b23bcc59c6aedab
|
|
| MD5 |
70e1e3e41ae0913deff846c28fb442b1
|
|
| BLAKE2b-256 |
7f9fc50df3f14b5a1d2d7d24f51b1c58b1c87ffc47f51715d59ed401807877f9
|
Provenance
The following attestation bundles were made for ai_rps_arena-0.2.0.tar.gz:
Publisher:
publish.yml on johnhuang316/ai-rps-arena
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_rps_arena-0.2.0.tar.gz -
Subject digest:
87ca41ff2a7bfd3c06a6c55bdd62ebc73310421329bc03524b23bcc59c6aedab - Sigstore transparency entry: 1243496330
- Sigstore integration time:
-
Permalink:
johnhuang316/ai-rps-arena@4b8103d5eb187b78f4f754031770e81aa46db7f7 -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/johnhuang316
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@4b8103d5eb187b78f4f754031770e81aa46db7f7 -
Trigger Event:
push
-
Statement type:
File details
Details for the file ai_rps_arena-0.2.0-py3-none-any.whl.
File metadata
- Download URL: ai_rps_arena-0.2.0-py3-none-any.whl
- Upload date:
- Size: 23.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
af6c52227898fcadc3451ca334d80442571cefe757e95e1570368387c2ce1a97
|
|
| MD5 |
0c4b8f1a02c39f4fb8484509b66288a0
|
|
| BLAKE2b-256 |
f5c4f586172945cc1ff10308f26120bf5fdf8f92425df477e109e63be35ca49a
|
Provenance
The following attestation bundles were made for ai_rps_arena-0.2.0-py3-none-any.whl:
Publisher:
publish.yml on johnhuang316/ai-rps-arena
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_rps_arena-0.2.0-py3-none-any.whl -
Subject digest:
af6c52227898fcadc3451ca334d80442571cefe757e95e1570368387c2ce1a97 - Sigstore transparency entry: 1243496339
- Sigstore integration time:
-
Permalink:
johnhuang316/ai-rps-arena@4b8103d5eb187b78f4f754031770e81aa46db7f7 -
Branch / Tag:
refs/tags/v0.2.0 - Owner: https://github.com/johnhuang316
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@4b8103d5eb187b78f4f754031770e81aa46db7f7 -
Trigger Event:
push
-
Statement type:
