NEAT-AI-core

Native shared Rust for NEAT-AI: the neat-core crate (tests included) lives here as a Cargo workspace member.

Test-driven development

Development in this repository follows TDD: do not merge behaviour changes unless cargo test --workspace already covers them (extend tests first when fixing bugs or adding APIs). Run ./quality.sh before every commit/PR.

WebAssembly

wasm_activation and pkg/ remain in the NEAT-AI repo on Develop — not in this repository.

Layout

Path	Role
neat-core/	Shared computation library; 233+ unit tests in src/**/*.rs.
Cargo.toml	Virtual workspace root; [workspace.package] holds semver for release automation.
deny.toml	cargo deny (licences, advisories, bans).
quality.sh	Local gate (fmt, clippy, tests, doc, deny).
LICENSE, .gitleaks.toml	Inherited from NEAT-AI Develop.

Build

export RUSTFLAGS="-D warnings"
cargo test --workspace
# or full gate:
./quality.sh

Related Repositories

The NEAT-AI project is split across seven public repositories. Each focuses on one concern and composes with the others as shown below.

Repository	Role
NEAT-AI	Primary Deno/TypeScript neural-network engine (evolution, training, WASM activation).
NEAT-AI-core	Shared native Rust library (neat-core) with numerics, topology helpers, and the chunked .bin training stream.
NEAT-AI-Discovery	Rust discovery module invoked by NEAT-AI via Deno FFI to search architectures and hyper-parameters.
NEAT-AI-Snapshot	Creature/genome snapshot format and fixtures produced by NEAT-AI and consumed by downstream tools.
NEAT-AI-scorer	Production forward-only scoring application built on neat-core via a path dependency.
NEAT-AI-Explore	Visualiser for creatures that reads NEAT-AI-Snapshot data.
NEAT-AI-Examples	Worked examples and tutorials that depend on NEAT-AI.

Dependency graph

graph TD
    Core[NEAT-AI-core<br/>Rust shared lib]
    Main[NEAT-AI<br/>Deno/TypeScript engine]
    Discovery[NEAT-AI-Discovery<br/>Rust, via Deno FFI]
    Snapshot[NEAT-AI-Snapshot<br/>creature data]
    Scorer[NEAT-AI-scorer<br/>Rust scorer app]
    Explore[NEAT-AI-Explore<br/>visualiser]
    Examples[NEAT-AI-Examples<br/>tutorials]

    Main -->|Deno FFI| Discovery
    Main -->|produces| Snapshot
    Scorer -->|path dependency| Core
    Explore -->|reads| Snapshot
    Examples -->|depends on| Main

Loading

License

Apache-2.0 — see LICENSE.