anemone

anemone is a Python library for tree search over valanga game states. It separates structural tree storage, runtime search state, node evaluation, exploration indices, and selector/opening logic so different search policies can share one coherent runtime.

Overview

The main architectural split is:

structure: TreeNode and ITreeNode
runtime: AlgorithmNode and TreeExploration
evaluation: direct evaluation plus backed-up tree evaluation
exploration: per-node exploration-index payloads and tree-wide recomputation
selection: selectors and opening instructions that decide what to expand next

Installation

pip install anemone

Optional extras:

pip install anemone[nn]
pip install anemone[debug]

Debug snapshot export and the debug browser's SVG rendering also require the system Graphviz executable (dot).

Getting started

The canonical public entry point is anemone.factory.create_search.

Use anemone.factory to build a runnable search runtime.
Treat anemone._runtime_assembly and anemone.search_factory as internal wiring layers behind that API.
Use TreeAndValueBranchSelector only when you want the higher-level one-shot recommendation wrapper instead of driving the runtime directly.

from random import Random

from anemone.factory import SearchArgs, create_search

# Domain-specific collaborators omitted for brevity:
# - YourStateType
# - your_dynamics
# - starting_state
# - your_evaluator
# - your_selector_args
# - your_opening_type
# - your_stopping_criterion
# - your_recommender_rule
args = SearchArgs(
    node_selector=your_selector_args,
    opening_type=your_opening_type,
    stopping_criterion=your_stopping_criterion,
    recommender_rule=your_recommender_rule,
)

runtime = create_search(
    state_type=YourStateType,
    dynamics=your_dynamics,
    starting_state=starting_state,
    args=args,
    random_generator=Random(0),
    master_state_value_evaluator=your_evaluator,
    state_representation_factory=None,
)

result = runtime.explore(Random(0))
print(result.branch_recommendation.recommended_name)

Core concepts

TreeNode: the concrete structural node storing state, depth, and links.
AlgorithmNode: the runtime wrapper that adds tree evaluation and exploration-index payloads.
direct_value: the immediate evaluator output for one node.
backed_up_value: the subtree-derived value propagated from children.
exploration index: optional per-node search-priority data recomputed across the tree by a configured strategy.

How it works

create_search(...) assembles the runtime, direct evaluator, selector factory, tree-evaluation factory, and tree manager.
The initial tree is created with a directly evaluated root node.
A selector chooses which node or branch to open next.
The tree manager expands the structure and creates any new runtime nodes.
Direct evaluation fills direct_value on newly created nodes.
Upward propagation recomputes backed_up_value, branch ordering, and principal variation.
Exploration-index payloads are refreshed for the next iteration.

Documentation

Metadata

Release files for algorhino-anemone 0.2.23

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for algorhino-anemone 0.2.23
File	Size	Uploaded
algorhino_anemone-0.2.23.tar.gz	427.8 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for algorhino-anemone 0.2.23
File	Interpreter	ABI	Platform	Reset
algorhino_anemone-0.2.23-py3-none-any.whl 428.1 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 855.9 kB

Release files / algorhino_anemone-0.2.23.tar.gz

Download URL	algorhino_anemone-0.2.23.tar.gz
Size	427.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`5d51ec5bd8e5c06494775efb2208a4578b9ebff5b0f2b23b50ceb68416324a5b`
BLAKE2b-256 checksum How to use checksums	`b4f9fee9383b5c60e3c3d8a72121ae57008a36a1da3a6387b9f54093e545e002`
Upload date	Sep 19, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/victorgabillon/anemone
Publishing commit: github.com/victorgabillon/anemone/tree/53cd6f7e2d8407dbb2b9c11fc1cff5c5e2ad9cff

Workflow

Publishing configuration: github.com/victorgabillon/anemone/blob/53cd6f7e2d8407dbb2b9c11fc1cff5c5e2ad9cff/.github/workflows/release.yml
Publishing logs: github.com/victorgabillon/anemone/actions/runs/35425161777/attempts/1

Artifact

Subject: algorhino_anemone-0.2.23.tar.gz
SHA-256 checksum: 5d51ec5bd8e5c06494775efb2208a4578b9ebff5b0f2b23b50ceb68416324a5b Verifying attestations

Release files / algorhino_anemone-0.2.23-py3-none-any.whl

Download URL	algorhino_anemone-0.2.23-py3-none-any.whl
Size	428.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`deb09805ad473c5cdcf1570a2b5c48c4bd8bf303c9c02bc3e5ee8c2f059ab01b`
BLAKE2b-256 checksum How to use checksums	`d08a317106f36da444d77243165ad445ac77868702f55ae80fac5a6b776123ce`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/victorgabillon/anemone
Publishing commit: github.com/victorgabillon/anemone/tree/53cd6f7e2d8407dbb2b9c11fc1cff5c5e2ad9cff

Workflow

Publishing configuration: github.com/victorgabillon/anemone/blob/53cd6f7e2d8407dbb2b9c11fc1cff5c5e2ad9cff/.github/workflows/release.yml
Publishing logs: github.com/victorgabillon/anemone/actions/runs/35425161777/attempts/1

Artifact

Subject: algorhino_anemone-0.2.23-py3-none-any.whl
SHA-256 checksum: deb09805ad473c5cdcf1570a2b5c48c4bd8bf303c9c02bc3e5ee8c2f059ab01b Verifying attestations