A handy package for kickstarting AI game environments.
✨ Why Seahorse?
Developing a game environnement for autonomous agents is complex. Seahorse is a lightweight Python framework for building turn‑based adversarial games and running matches with AI agents. This package is battle-tested and tailored to educational use cases
- Define your own game – describe the states, rules, possible moves, and winning condition.
- Plug in any agent – implement the decision logic once.
- Interaction via proxies - agents can compete whether they are all run locally or on another machine. human can also play against agent through an interactive GUI.
- Let the master run the match – the built‑in game master enforces turn order, time budgets, move legality, and determines winners.
- Real‑time communication – a server broadcasts game states and collects actions, making remote play and live recording effortless.
📦 Installation
pip install seahorse
📖 Documentation & Examples
For detailed tutorials, references, and advanced examples, please visit our full documentation: corail-research.github.io/seahorse/
🤝 Contributing
We welcome contributions! If you encounter a bug, have a feature request, or want to improve the documentation, please fork the repository and open a pull request.
Main contributors
We are an enthusiastic team of M.Sc. and PhD candidates led by Pr. Quentin Cappart at Polytechnique Montréal. The package was originally developed in the context of an introductory course to artificial intelligence given to computer and software engineering students.
License
seahorse is distributed under the BSD 3‑Clause License. See the LICENSE file for details.
1 maintainer
Release files for seahorse 1.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| seahorse-1.2.4.tar.gz | 8.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| seahorse-1.2.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.3 MB
Release files / seahorse-1.2.4.tar.gz
| Download URL | seahorse-1.2.4.tar.gz |
|---|---|
| Size | 8.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0e210a8d6b493fc8de4e8182a10607da968b703bc76188de76df8bffdc103513
|
|
BLAKE2b-256 checksum How to use checksums |
14db7970a35d6f3a6f6ea09a86d162ebfabe2ae666758bf5973c242666cdc3e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logRelease files / seahorse-1.2.4-py3-none-any.whl
| Download URL | seahorse-1.2.4-py3-none-any.whl |
|---|---|
| Size | 42.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d48f3b1646da3a78db61a75af66dcde1c7af3380d97e204800841ff4ebd7e483
|
|
BLAKE2b-256 checksum How to use checksums |
750d57ee10f81e52469a90cbf73a148a218990438e32eb69788cf94fccfb1fda
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency log
