EAISports CLI

AI-powered game building CLI. Creators use their own AI compute (via OpenRouter, Nous, or other providers) to build browser games from a text description, then publish to eaisports.ai.

Install

pip install eaisports

Requires Python 3.11+.

Quickstart

# 1. Set up API key, model, and wallet
eaisports init

# 2. Build a game
eaisports build my-trivia-game
# or describe what you want
eaisports build -d "a space shooter with power-ups"

# 3. Preview locally
eaisports preview my-trivia-game

# 4. Deploy to eaisports.ai
eaisports push my-trivia-game

Configuration

Config lives in ~/.eaisports/. Run eaisports init for interactive setup, or set environment variables:

# Required: OpenRouter API key (https://openrouter.ai/keys)
export OPENROUTER_API_KEY=sk-or-...

# Optional: default model (default: anthropic/claude-opus-4.6)
export LLM_MODEL=anthropic/claude-opus-4.6

Multiple inference providers are supported — OpenRouter, Nous Research, OpenAI Codex, and custom endpoints. Run eaisports model to switch providers interactively.

Commands

Core

Interactive Agent

Skills

Configuration & Diagnostics

Sessions & History

Other

Skills

Skills are reusable game templates that seed the AI build process. Bundled skills:

• interactive-fiction — Text-based narrative games with branching storylines
• trivia — Quiz games with categories, scoring, and timers
• puzzle-logic — Logic puzzles, pattern matching, and brain teasers
• game-ui — Reusable UI components (menus, HUDs, leaderboards)
• mobile — Mobile-optimized game templates

Skills live in ~/.eaisports/skills/{name}/SKILL.md with YAML frontmatter. You can create your own, install from online registries (official, GitHub, community), or let the agent auto-extract reusable patterns from your builds.

Wallet & Deployment

Games are deployed to eaisports.ai via eaisports push. Creator identity is backed by a Solana wallet — run eaisports init to connect yours via a browser-based device code flow. The CLI bundles the Vite build output, verifies it, and uploads with JWT authentication.

Agent & Tools

The interactive agent (eaisports chat) has access to 40+ tools:

• File & code — Read, write, patch, and search files
• Terminal — Execute commands across local, Docker, Modal, SSH, Singularity, and Daytona backends
• Web & browser — Search the web, crawl pages (Firecrawl), and automate browsers
• Skills — List, view, create, and manage game skills with security scanning
• Memory — Persistent agent memory across sessions
• MCP — Connect external Model Context Protocol servers
• Planning — Todo lists, filesystem checkpoints, and rollback

The agent supports OpenAI-compatible tool calling, automatic context compression, and session persistence (SQLite + FTS5 search).

Architecture

eaisports_cli/         CLI commands (init, build, preview, push, stats, skills, config)
agent/                 AI agent runtime (prompt building, context compression, sessions)
tools/                 40+ tools (file, terminal, web, browser, skills, memory, MCP)
tools/environments/    Execution backends (local, docker, modal, singularity, ssh, daytona)
skills/                Bundled game skill templates
cron/                  Scheduled task system
run_agent.py           AIAgent class (OpenAI-compatible tool calling loop)
cli.py                 Interactive terminal UI (Rich + prompt_toolkit)
eaisports_state.py     Session management (SQLite + FTS5)

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/ -x

# Import check
python -c "import eaisports_cli"

# Smoke test
python -m eaisports_cli.main --help

Acknowledgments

EAISports is built on the shoulders of Hermes Agent by Nous Research. The core agent runtime, tool-calling loop, memory system, and session management are derived from their open-source work under the MIT License.

License

MIT — see LICENSE for details.