Metadata-Version: 2.5
Name: arenamcp
Version: 3.0.0
Summary: AI-powered real-time coaching and autopilot for Magic: The Gathering Arena
Project-URL: Homepage, https://github.com/josharmour/mtgacoach
Project-URL: Releases, https://github.com/josharmour/mtgacoach/releases
Project-URL: Issues, https://github.com/josharmour/mtgacoach/issues
License-Expression: MIT
Keywords: ai,assistant,coaching,magic-the-gathering,mtga
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.10
Requires-Dist: keyboard>=0.13.5
Requires-Dist: kokoro-onnx
Requires-Dist: mcp<2,>=1.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: openai>=1.0.0
Requires-Dist: pillow>=10.0.0
Requires-Dist: pyside6>=6.7.0
Requires-Dist: requests>=2.28.0
Requires-Dist: sounddevice>=0.4.6
Requires-Dist: soundfile>=0.12.0
Requires-Dist: watchdog>=3.0.0
Provides-Extra: autopilot
Requires-Dist: pyautogui>=0.9.54; extra == 'autopilot'
Requires-Dist: pydirectinput-rgx>=1.0.0; extra == 'autopilot'
Provides-Extra: desktop
Provides-Extra: dev
Requires-Dist: mypy>=1.10.0; extra == 'dev'
Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
Requires-Dist: prometheus-client>=0.20.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: anthropic>=0.18.0; extra == 'full'
Requires-Dist: beautifulsoup4>=4.12.0; extra == 'full'
Requires-Dist: google-genai>=1.0.0; extra == 'full'
Requires-Dist: lxml>=5.0.0; extra == 'full'
Requires-Dist: networkx>=3.0; extra == 'full'
Requires-Dist: ollama>=0.1.0; extra == 'full'
Requires-Dist: pyautogui>=0.9.54; extra == 'full'
Requires-Dist: pydirectinput-rgx>=1.0.0; extra == 'full'
Requires-Dist: scipy>=1.10.0; extra == 'full'
Requires-Dist: websocket-client>=1.6.0; extra == 'full'
Provides-Extra: llm
Requires-Dist: anthropic>=0.18.0; extra == 'llm'
Requires-Dist: google-genai>=1.0.0; extra == 'llm'
Requires-Dist: ollama>=0.1.0; extra == 'llm'
Provides-Extra: scraping
Requires-Dist: beautifulsoup4>=4.12.0; extra == 'scraping'
Requires-Dist: lxml>=5.0.0; extra == 'scraping'
Requires-Dist: networkx>=3.0; extra == 'scraping'
Provides-Extra: voice
Description-Content-Type: text/markdown

# mtgacoach — AI-Powered MTGA Coaching & Overlay

Real-time AI coaching for Magic: The Gathering Arena. MTGA Coach tracks your live games and provides real-time strategic advice, draft guidance, voice coaching, and an in-game HUD overlay directly on top of MTGA.

---

## Features

- **Real-Time AI Coaching**: Tracks your board, hand, opponent cards, and legal moves to deliver turn-by-turn strategic advice.
- **In-Game HUD Overlay**: Transparent, click-through overlay sits directly on top of MTGA showing coach advice, draft ratings, and target highlights.
- **Draft Assistance**: Live 17Lands-powered card ratings, composite tier badges, and optimal color-pair recommendations during drafts.
- **Voice Coaching**: Spoken advice with neural Text-to-Speech (TTS) and hands-free Push-to-Talk voice questions.
- **Online AI Backend**: All coaching runs through the `api.mtgacoach.com` gateway — a license key from [mtgacoach.com](https://mtgacoach.com) is required.

---

## Installation

### Standard Windows Installer
Download and run **`mtgacoach-Setup.exe`** from the [Latest Release](https://github.com/josharmour/mtgacoach/releases/latest).

---

### Command-Line Install (`uv` / `pip`)

The package (`arenamcp`) is not published on PyPI — install from source on Windows, macOS, or Linux using [`uv`](https://docs.astral.sh/uv/) or `pip`:

```bash
# 1. Install uv (if not already installed):
#    Windows (PowerShell): powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
#    macOS / Linux:       curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Clone and install mtgacoach from source:
git clone https://github.com/josharmour/mtgacoach.git
cd mtgacoach
uv venv
uv pip install -e ".[full]"
# (or with plain pip: python -m pip install -e ".[full]")

# 3. Launch the app:
uv run mtgacoach-desktop
```

Alternatively, each [release](https://github.com/josharmour/mtgacoach/releases/latest) attaches a Python wheel (`arenamcp-X.Y.Z-py3-none-any.whl`) that can be installed directly with `uv tool install <wheel-url>`.

---

## First Run & Setup

1. Launch `mtgacoach-desktop`.
2. Open the **Repair** tab — it automatically verifies your MTGA installation, Python runtime, license key, and game logging setup.
3. Ensure **Detailed Logs (Plugin Support)** is enabled in MTGA's Account Options menu.

---

## License

MIT License
