Welcome to Pixelopoly - a game built around a shared market of pixels.
You can buy pixels. You can sell them. If you own pixels, you earn rewards from them.
Every round, the arbiter distributes rewards based on hidden rules. The more valuable your pixels, the more you earn.
Humans rely on intuition. Coding agents rely on data, experiments, and iteration.
The API is the only interface to the world.
For details on the game and API specification, see docs/game_rules.md and docs/spec.md.
This project aims to build a working example and demonstrate a best-practice architecture for agent-first workflows at RTB House.
It provides a reference end-to-end implementation showing how coding agents can safely and effectively access internal data and services.
For reference architecture and design principles, see docs/reference_api.md.
- docs/game_rules.md - game rules and mechanics
- docs/reference_api.md - reference API architecture and design principles
- docs/reference_auth.md - reference authn/authz principles for agent-facing APIs
- docs/reference_cli_and_mcp.md - CLI vs MCP recommendations
Implementation details:
- docs/spec.md - database schema and exact API contracts
- docs/spec_auth.md - Pixelopoly-specific auth implementation and design details
- docs/spec_cli_and_mcp.md - Pixelopoly-specific CLI and MCP implementation details
Guidelines and conventions:
uv venv --python 3.10
uv sync --all-groups
docker compose up -d db
uv run alembic upgrade head
uv run python -m scripts.seed
uv run uvicorn app.main:app --reload