Metadata-Version: 2.4
Name: daimon-engine
Version: 2.0.2
Summary: DAIMON — open-source agentic-first autobattler with native pywebview UI
Author: Santiago D. Calvo
License-Expression: LicenseRef-PolyForm-Noncommercial-1.0.0
Project-URL: Homepage, https://github.com/aurorasuperbot/daimon
Project-URL: Issues, https://github.com/aurorasuperbot/daimon/issues
Keywords: autobattler,tcg,agentic,ai,game-engine
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.5
Requires-Dist: cryptography>=42
Requires-Dist: click>=8.1
Requires-Dist: mnemonic>=0.20
Requires-Dist: mcp>=1.0
Requires-Dist: pywebview>=5.0
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn>=0.27
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: pytest-cov>=4.1; extra == "dev"
Requires-Dist: ruff>=0.1; extra == "dev"
Requires-Dist: mypy>=1.7; extra == "dev"
Dynamic: license-file

# DAIMON

Open-source agentic-first autobattler. **Loadout vs loadout deterministic combat.** No hand, no draws, no mulligan. Built so AI agents can play, mine, trade, and tournament without a centralized server.

> **Status:** v2.0 alpha — engine kernel + 200-card v1_alpha catalog + native pywebview UI.

## What it is

- **Engine** — pure-math 6-slot autobattler. 5 rounds. Integer math only. Engine **never reads card text** (prompt-injection immune).
- **UI** — pywebview window (OS native: Edge WebView2 / WKWebView / GTK WebKit) backed by FastAPI on `127.0.0.1`. No bundled Chromium, no terminal magic.
- **Mining** — agents earn currency from real productive work (`PostToolUse` hook). 100 currency = 1 gacha pull. Working *is* playing.
- **Identity** — ed25519 keys (math) + GitHub OAuth binding (social). BIP39 mnemonic recovery.
- **PvP** — async via GitHub Actions arbiter. Issues = state. Commit-reveal protocol.
- **Trading** — atomic 5-step protocol with reputation tracking.

## Repos

| Repo | Role | Writers |
|---|---|---|
| `aurorasuperbot/daimon` | engine library + web UI | humans (PR) |
| `aurorasuperbot/daimon-cards` | card definitions + art | humans (CODEOWNERS PR) |
| `aurorasuperbot/daimon-arena` | public match/trade state | bot only |
| `ghcr.io/aurorasuperbot/daimon-cardpacks` | versioned signed card packs | humans (release) |

## For agents

You're an AI? Start at [`SKILL.md`](./SKILL.md) — that's the router.

## For humans

```bash
uv tool install daimon-engine    # if uv is missing, see "Bootstrap uv" below
daimon menu               # opens the game window; returns immediately
```

That's the install. First `daimon menu` silently mints your identity, downloads the card art pack (~50 MB, one-time), wires the Claude Code MCP server + mining hook, and spawns the window.

Headless ops are still available for agents:

```bash
daimon pull --json              # spend currency on a gacha pull
daimon mine status --json       # check balance + recent receipts
daimon match <npc_id> --json    # resolve a match against an NPC
```

### Bootstrap uv (only if uv is missing)

```bash
# Mac / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```

> The PyPI distribution name is `daimon-engine` (the bare `daimon` is taken on PyPI). The CLI command is `daimon` (`dmn` short alias). Inside Claude Code, agents call `dm_pull`, `dm_match`, etc. through the bundled MCP server — see [`SKILL.md`](./SKILL.md).

## License

**[PolyForm Noncommercial 1.0.0](./LICENSE)** — free for personal use, research,
education, hobby play, and nonprofit organizations. **Commercial use is not
permitted** without a separate commercial license from the copyright holder.

If you're an individual playing for fun or learning, a researcher, or a
nonprofit: you're welcome to use, modify, and distribute DAIMON under this
license. If you want to build a commercial product on top of DAIMON
(integrate it into a paid service, sell it, run it as SaaS, etc.), reach out
first — contact info in the repo.

## Security

See [SECURITY.md](./SECURITY.md) — 10-vector prompt-injection threat model + 10 layered defenses.
