You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Rebrand README with the e mark and align content with the redesign
Adds the branded header from the redesign: the Fraunces-rendered green
e tile mark, the evo.fugue.run hero tagline, and a badge row. Adds a
Documentation section (user guide, playground, docs.rs), fixes the
Fugue link to the real repo (alexnodeland/fugue, not the stale
fugue-ppl org), and updates the Development section's fugue-ppl
version references from 0.1.0 to the actual 0.2.0.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018yo1jdkckG7yQ9eBqLbaDB
**Evolution as Bayesian inference — a probabilistic, type-safe evolutionary computation library for Rust**
8
+
9
+
*Populations hunting real landscapes, live in your browser: every figure in the docs at [evo.fugue.run](https://evo.fugue.run) runs the actual crate, compiled to WASM.*
A broad evolutionary-computation library for Rust, with an optional probabilistic-programming bridge to [Fugue](https://github.com/alexnodeland/fugue).
4
20
5
21
The default flagship algorithms (SimpleGA, CMA-ES, NSGA-II, Island Model, Evolution Strategy, EDA/UMDA, SteadyState) are standalone evolutionary computation: they use Fugue's `Trace` only as an address→value data container for the optional `to_trace`/`from_trace` round-trip, not for inference. The genuine "evolution as Bayesian inference over solution spaces" story — a tempered Sequential Monte Carlo pipeline over Fugue's `Model`/`Handler`/`factor` machinery — lives in the `fugue_integration` module (`EvolutionarySMC`/`EvolutionStep`/`BayesianAdaptiveGA`), demonstrated by `examples/bayesian_evolution.rs`. Reach for that module, not the default algorithms, when you want the PPL-powered inference path (EV-17).
6
22
@@ -70,6 +86,12 @@ Run an example:
70
86
cargo run --example sphere_optimization
71
87
```
72
88
89
+
## Documentation
90
+
91
+
-**[User Guide](https://evo.fugue.run/)** - Tutorials, how-to guides, and reference, with live WASM-backed figures throughout
92
+
-**[Playground](https://evo.fugue.run/playground.html)** - Drive all five algorithms in the browser: SimpleGA, CMA-ES, NSGA-II, islands, UMDA
93
+
-**[API Reference](https://docs.rs/fugue-evo)** - Complete API documentation
94
+
73
95
## Core Concepts
74
96
75
97
### Fitness as Likelihood
@@ -132,7 +154,7 @@ crates were never exercised against together:
132
154
133
155
```toml
134
156
[dependencies]
135
-
fugue-ppl = { path = "../fugue", version = "0.1.0" }
157
+
fugue-ppl = { path = "../fugue", version = "0.2.0" }
136
158
```
137
159
138
160
Both crates live side by side under the same `fugue-ecosystem` parent
@@ -141,15 +163,15 @@ committed default once `fugue`'s own 2026-07 audit remediation landed with a
141
163
green full-test gate; earlier in the remediation the sibling checkout was
142
164
frequently mid-edit and momentarily uncompilable, which is why the dependency
143
165
had been pinned to the published registry release until the sibling stabilized.
144
-
The `version = "0.1.0"` field is honored if `fugue-ppl` is ever resolved from
166
+
The `version = "0.2.0"` field is honored if `fugue-ppl` is ever resolved from
145
167
crates.io instead (e.g. the sibling checkout is absent).
146
168
147
169
To build against the published crates.io release rather than your local
148
170
`../fugue` checkout, replace the dependency with:
149
171
150
172
```toml
151
173
[dependencies]
152
-
fugue-ppl = "0.1.0"
174
+
fugue-ppl = "0.2.0"
153
175
```
154
176
155
177
Run `cargo check` after switching either way to confirm the resolved `fugue`
0 commit comments