Skip to content

Bytefray 5.0.0 Alpha 1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@libertaine libertaine released this 10 Sep 03:06
· 55 commits to main since this release
b5.0.0-alpha1
28a10b8

Bytefray 5.0.0 Alpha 1

Bytefray is a deterministic programmable-agent arena where Python agents move,
observe, and compete over shared memory. Bytefray 5 begins establishing the
project's post-Core-War identity while retaining the proven stable V4 gameplay
ruleset.

Highlights

  • Four new educational V5 starters demonstrate stronger objective-capable
    behavior: attacking regions, finding contacts, defending a core, and teamwork.
  • Agent API v2 authoring includes blank and annotated scaffolds, parameter
    schemas with validation, and named presets.
  • The Designer generates typed controls from agent schemas, shows effective
    values, and provides an explicit Randomize Seed action.
  • Deterministic execution supports reproducible matches; result and replay
    metadata expose the effective agent parameters.
  • Bundled-starter refresh updates recognized pristine copies and preserves
    customized agents.
  • Packaging and cross-platform hardening cover API-v2 scaffold resources,
    clean packaged contents, Windows installed workflows, and Linux wheel/source
    installation. Runtime Python support is 3.10–3.14.

Meet the V5 starters

Agent Lesson
v5_region_attacker Apply pressure across an objective-sized region.
v5_scout_striker Search, remember a contact, then strike.
v5_core_defender Observe your core and repair confirmed losses.
v5_dual_team Coordinate a raider and keeper with a shared action budget.

These are readable teaching agents, with deliberate trade-offs and tunable
parameters. See the V5 starter guide.

Agent authoring

Use API v2: initialize in reset, return your roster of ProcessDeclaration
objects from declare_processes, and respond to ObservationV2 in act.
Use the deterministic RNG supplied by MatchContextV2. Parameter resolution is
defaults < preset < explicit override.

Start with the Agent API v2 authoring guide
and scaffolding and validation workflow.

Compatibility

Historical V4 starters remain available, and Agent API v1 retains its existing
compatibility path. Stable gameplay remains bytefray-rules-4, the default for
an API-v2 roster. Product version 5.0.0a1 does not introduce a
bytefray-rules-5 gameplay ruleset.

Installation

  • Windows AMD64: use Bytefray-Setup-5.0.0a1.exe for the complete applications;
    administrative installation is required. Launch Agent Designer from the
    Bytefray Start Menu group. The installer does not add commands to PATH.
  • Individual Windows executable assets: bytefray.exe, bytefray-cli.exe,
    bytefray-agent-designer.exe, and bytefray-replay-viewer.exe are the qualified
    launcher binaries. They require their matching adjacent PyInstaller runtime
    directories and resources; a downloaded .exe alone is not a portable app.
    Use the installer to obtain the complete layouts.
  • Python wheel: download bytefray-5.0.0a1-py3-none-any.whl, activate a virtual
    environment, then run
    python -m pip install ./bytefray-5.0.0a1-py3-none-any.whl.
    The core CLI is headless; optional replay and designer extras provide the
    desktop tools. These instructions install the GitHub asset, not a PyPI release.
  • Source distribution: bytefray-5.0.0a1.tar.gz supports source installation.
    Linux wheel and source installation were qualified on Ubuntu 24.04 under WSL2.

Alpha notice

This is an Alpha release. Interfaces, starter behavior, and UX may continue
to evolve before Bytefray 5.0.0 final.

Qualified source: 28a10b8f8fd47bf32ec9281dcc21b0645276962c.
Release tag: b5.0.0-alpha1.

SHA-256 checksums

BB8B6AD47D3C8B481415A72DD7514FD13159F6417AB71169689B9A2302BC252A  bytefray-5.0.0a1-py3-none-any.whl
03AAF95EFA6A87409789D10EEE5D91626B40A6561BE637CD42968B9818E9917A  bytefray-5.0.0a1.tar.gz
932C982B2C727422DFF61A1D343D56A94099B661A6D8E82D6482335DD3DBCE12  bytefray.exe
43BE230CEEBAF18E3D864E55A2B73E784D154051A1B2448B5690CA750E36CCED  bytefray-cli.exe
9B91FED22D18C3492C9449AE4A278E71FE00DEEFC490DCBB7825C6912A356520  bytefray-agent-designer.exe
D7B1F2B2EC8E1E8ABF76493D1D8E0AC72C8CAD980570265A6C0D0774EA94431B  bytefray-replay-viewer.exe
DFAA25609405CA170BED0DF7A6E684FC72F316B91FD846837F79909D3B07379F  Bytefray-Setup-5.0.0a1.exe
Assets 9
Loading