# Install homeworlds with Homebrew C++ framework for the game of Binary Homeworlds. Version 1.1.0 via Homebrew; verified 2026-07-08. ## Install ```sh sudo av install brew:homeworlds ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install homeworlds ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:homeworlds - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.1.0 - **Source summary:** C++ framework for the game of Binary Homeworlds - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** BSD-2-Clause - **Source archive:** - **Last updated:** 2026-07-08T03:44:56Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - homeworlds-cli (cli) - homeworlds-wx (cli) - homeworlds-cli (alias) - homeworlds-wx (alias) ## Dependencies - wxwidgets ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.1.0 - Package-manager updated: 2026-07-08 - Local data: ok - Upstream repository: https://github.com/Quuxplusone/Homeworlds - Upstream latest detected: v1.1.0 (current) ## Project history and usage Homeworlds is a C++ implementation framework for Binary Homeworlds, the abstract strategy game associated with Icehouse/Pyramid pieces. The package is less a general-purpose game engine than a programmer's toolkit: it exposes game-state data structures, move generation, move application, incomplete-move inference, a command-line analyzer, a wxWidgets GUI experiment, and a Python extension around the same core rules. ### Project history Arthur O'Dwyer's repository presents the project as a C++14 codebase for studying and playing Binary Homeworlds, including a text interface to a simple AI. The README explains the internal model in terms of `SingleAction`, `WholeMove`, `PieceCollection`, `StarSystem`, and `GameState`, then layers command-line, GUI, and Python-extension interfaces on top of that core. The repository also includes a SuperDuperGames.org archive import path: a partial mirror of more than 700 game transcripts and scripts to translate those transcripts into formats consumed by `homeworlds-cli` and `libhomeworlds`. That gives the package a historical-data angle uncommon for small board-game CLI packages. ### Adoption history The project entered package-manager culture through Homebrew as a niche game/programming formula rather than as a broad end-user application. Its audience is mostly Binary Homeworlds players, combinatorial-game experimenters, and C++ users interested in AI search over an unusually high-branching abstract game. ### How it is used The `homeworlds-cli` executable can be used to play or analyze a game by entering moves and asking the built-in AI for a move. The library side is useful for generating legal moves, applying moves to a state, and experimenting with alternative evaluation or pruning strategies. The package also ships `homeworlds-wx`, but the README frames it as an experiment with a graphical interface. For package users, the CLI and C++/Python library surfaces are the more reproducible pieces. ### Why package nerds care Homeworlds is a good example of the long tail that keeps Homebrew interesting: a formula can package a specialized research/play tool, not only mainstream developer utilities. It also demonstrates the packaging friction around C++ GUI dependencies and small AI/game analyzers that are useful to a narrow but technically engaged community. ### Timeline - 2011: GitHub repository lineage is visible through repository metadata embedded in GitHub pages. - 2015: Tagged releases `v1.0.0` and `v1.1.0` appear in the Git repository. - 2015: `libhomeworlds` package metadata identifies version 1.1.0 and describes the Python extension as AI for Binary Homeworlds written in C++. ### Related projects - Binary Homeworlds and Icehouse/Pyramid games provide the game rules and physical-piece context. - SuperDuperGames.org is related because the repository includes a partial archive and conversion scripts for historical game transcripts. - wxWidgets and Python extension tooling are related implementation surfaces around the C++14 core. ### Sources - Git tags and setup.py: tagged 1.x releases and libhomeworlds metadata. - GitHub README: project description, components, CLI, GUI, Python extension, and SuperDuperGames archive. - Homebrew formula metadata from input: package-manager presence and executables. ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** homeworlds - **Version Scheme:** 1 - **Revision:** 4 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [wxwidgets](https://www.automicvault.com/pkg/brew/wxwidgets/) - Runtime dependency declared by Homebrew. - [hexgui](https://www.automicvault.com/pkg/brew/hexgui/) - Shares av.db curated category or tags: board-game, cli, games. - [nettoe](https://www.automicvault.com/pkg/brew/nettoe/) - Shares av.db curated category or tags: board-game, cli, game, games. - [pioneers](https://www.automicvault.com/pkg/brew/pioneers/) - Shares av.db curated category or tags: board-game, cli, games. - [gnuski](https://www.automicvault.com/pkg/brew/gnuski/) - Shares av.db curated category or tags: c-plus-plus, cli, game, games. - [allureofthestars](https://www.automicvault.com/pkg/brew/allureofthestars/) - Shares av.db curated category or tags: cli, game, games. - [angband](https://www.automicvault.com/pkg/brew/angband/) - Shares av.db curated category or tags: cli, game, games. - [avanor](https://www.automicvault.com/pkg/brew/avanor/) - Shares av.db curated category or tags: cli, game, games. - [ballerburg](https://www.automicvault.com/pkg/brew/ballerburg/) - Shares av.db curated category or tags: cli, game, games. - [pokerstove](https://www.automicvault.com/pkg/brew/pokerstove/) - Local package facts share a topical domain. Shared terms: c-plus-plus, cli, games, plus. - [cataclysm](https://www.automicvault.com/pkg/brew/cataclysm/) - Local package facts share a topical domain. Shared terms: cli, game, games. - [dsda-doom](https://www.automicvault.com/pkg/brew/dsda-doom/) - Local package facts share a topical domain. Shared terms: cli, game, games, plus. ## Combined YAML source View the package source record on GitHub. [combined/homeworlds.yml](https://github.com/automic-vault/db/blob/main/combined/homeworlds.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph