evonet 0.1.0.dev23__tar.gz → 0.1.0.dev25__tar.gz

{evonet-0.1.0.dev23 → evonet-0.1.0.dev25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: evonet
-Version: 0.1.0.dev23
+Version: 0.1.0.dev25
 Summary: Evolvable neural network core for integration with EvoLib
 Author-email: EvoLib <evolib@dismail.de>
 License: MIT License
@@ -50,30 +50,54 @@ Requires-Dist: myst-parser; extra == "docs"
 Dynamic: license-file
 
 # EvoNet
+
 [![Code Quality & Tests](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml/badge.svg)](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Project Status: Alpha](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/EvoLib/evo-net)
 
-**EvoNet** is a modular and evolvable neural network core designed for integration with [EvoLib](https://github.com/EvoLib/evo-lib).
-It supports dynamic topologies, recurrent connections, per-neuron activation, and structural evolution – with a strong emphasis on **clarity**, **transparency**, and **didactic value**.
+**EvoNet** is a modular and evolvable neural network core designed for integration
+with [EvoLib](https://github.com/EvoLib/evo-lib).  
+It supports dynamic topologies, recurrent connections, per-neuron activation, and
+structural evolution, with a strong emphasis on clarity and explicit behaviour.
+
+---
+
+## Scope
+
+EvoNet is not a state-of-the-art or general-purpose deep learning framework.
+
+It does not aim to compete with libraries such as PyTorch, TensorFlow, or JAX in terms
+of performance, scalability, or training algorithms. Backpropagation, GPU acceleration,
+and highly optimised tensor operations are outside the scope of this project.
+
+Instead, EvoNet is designed for evolutionary algorithms, structural mutation, and
+exploratory research, with a focus on transparent and explicit implementations rather
+than performance optimisation or feature completeness.
+
+EvoNet should be understood as a conceptual and experimental model, not as a
+production-grade neural-network engine.
 
 ---
 
 ## Features
 
-- **Layer-based but flexible** – allows skip connections, cycles, and recurrent paths
+- **Explicit, layer-based topology** with support for skip connections, cycles,
+  and recurrent paths
 - **Typed neuron roles and connection types** (`NeuronRole`, `ConnectionType`)
-- **Topology-aware mutation system** – add/remove neurons and connections, mutate weights, change activations
-- **Per-neuron activation functions** – configurable, extensible, evolvable
-- **1-step recurrent state logic** – avoids multi-pass stabilization
-- **Topology can grow at runtime** – with `add_neuron`, `add_connection`, `split_connection`
-- **Debug-friendly architecture** – explicit IDs, labels, roles, directional graphs
-- **Designed for evolutionary learning** – mutation, crossover, speciation ready
-- **Lightweight & extensible** – pure Python, NumPy-based, no hard dependencies
+- **Topology-aware mutation operations**:
+  add/remove neurons and connections, mutate weights, change activations
+- **Per-neuron activation functions**, configurable and evolvable
+- **Explicit 1-step recurrent state model**, without iterative stabilisation passes
+- **Runtime topology growth**, e.g. via `add_neuron` and `add_connection`
+- **Debug-friendly architecture** with explicit neuron IDs, labels, roles,
+  and directional graphs
+- **Designed for evolutionary integration**, not gradient-based training
+- **Lightweight and extensible**: pure Python, NumPy-based, no hard dependencies
 
 ---
 
-> ⚠️ **This project is in early development (alpha)**. Interfaces and structure may change.
+> ⚠️ **Project status: Alpha**  
+> Interfaces, APIs, and internal structure may change as the project evolves.
 
 ---
 
@@ -83,14 +107,15 @@ It supports dynamic topologies, recurrent connections, per-neuron activation, an
 from evonet.core import Nnet
 
 net = Nnet()
-net.add_layer()  # Input
-net.add_layer()  # Output
+net.add_layer()  # Input layer
+net.add_layer()  # Output layer
 
-net.add_neuron(layer_idx=0, activation="linear", lable="in")
-net.add_neuron(layer_idx=1, activation="linear", bias=0.5, lable="out", connect_layer=True)
+net.add_neuron(layer_idx=0, activation="linear", label="in")
+net.add_neuron(layer_idx=1, activation="linear", bias=0.5, label="out")
 
 print(net.calc([1.0]))
 ```
+---
 
 ## License
 

evonet-0.1.0.dev25/README.md

@@ -0,0 +1,72 @@
+# EvoNet
+
+[![Code Quality & Tests](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml/badge.svg)](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Project Status: Alpha](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/EvoLib/evo-net)
+
+**EvoNet** is a modular and evolvable neural network core designed for integration
+with [EvoLib](https://github.com/EvoLib/evo-lib).  
+It supports dynamic topologies, recurrent connections, per-neuron activation, and
+structural evolution, with a strong emphasis on clarity and explicit behaviour.
+
+---
+
+## Scope
+
+EvoNet is not a state-of-the-art or general-purpose deep learning framework.
+
+It does not aim to compete with libraries such as PyTorch, TensorFlow, or JAX in terms
+of performance, scalability, or training algorithms. Backpropagation, GPU acceleration,
+and highly optimised tensor operations are outside the scope of this project.
+
+Instead, EvoNet is designed for evolutionary algorithms, structural mutation, and
+exploratory research, with a focus on transparent and explicit implementations rather
+than performance optimisation or feature completeness.
+
+EvoNet should be understood as a conceptual and experimental model, not as a
+production-grade neural-network engine.
+
+---
+
+## Features
+
+- **Explicit, layer-based topology** with support for skip connections, cycles,
+  and recurrent paths
+- **Typed neuron roles and connection types** (`NeuronRole`, `ConnectionType`)
+- **Topology-aware mutation operations**:
+  add/remove neurons and connections, mutate weights, change activations
+- **Per-neuron activation functions**, configurable and evolvable
+- **Explicit 1-step recurrent state model**, without iterative stabilisation passes
+- **Runtime topology growth**, e.g. via `add_neuron` and `add_connection`
+- **Debug-friendly architecture** with explicit neuron IDs, labels, roles,
+  and directional graphs
+- **Designed for evolutionary integration**, not gradient-based training
+- **Lightweight and extensible**: pure Python, NumPy-based, no hard dependencies
+
+---
+
+> ⚠️ **Project status: Alpha**  
+> Interfaces, APIs, and internal structure may change as the project evolves.
+
+---
+
+## Quick Example
+
+```python
+from evonet.core import Nnet
+
+net = Nnet()
+net.add_layer()  # Input layer
+net.add_layer()  # Output layer
+
+net.add_neuron(layer_idx=0, activation="linear", label="in")
+net.add_neuron(layer_idx=1, activation="linear", bias=0.5, label="out")
+
+print(net.calc([1.0]))
+```
+---
+
+## License
+
+MIT License - see [MIT License](https://github.com/EvoLib/evo-net/tree/main/LICENSE).
+

{evonet-0.1.0.dev23 → evonet-0.1.0.dev25}/evonet/core.py

@@ -117,11 +117,14 @@ class Nnet:
         label: str = "",
         role: NeuronRole = NeuronRole.HIDDEN,
         count: int = 1,
+        dynamics_name: str = "standard",
+        dynamics_params: dict[str, float] | None = None,
         connection_init: Literal["random", "zero", "near_zero", "none"] = "zero",
         recurrent: Optional[set[RecurrentKind]] = None,
         connection_scope: Literal["adjacent", "crosslayer"] = "adjacent",
         connection_density: float = 1.0,
         max_connections: int = 2**63 - 1,
+        require_io_connections: bool = True,
     ) -> list[Neuron]:
         """
         Add one or more neurons to the network.
@@ -147,6 +150,9 @@ class Nnet:
                 that should actually be created. Must be in [0, 1].
             max_connections:
                 Hard limit for the number of created connections per neuron.
+            require_io_connections:
+                If True, ensure that each newly added neuron has at least
+                one incoming and one outgoing connection (if structurally possible).
 
         Returns:
             list[Neuron]: The created neuron objects.
@@ -172,6 +178,10 @@ class Nnet:
             neuron = Neuron(activation=activation, bias=bias)
             neuron.role = role
             neuron.label = label
+
+            neuron.dynamics_name = dynamics_name
+            neuron.dynamics_params = dict(dynamics_params) if dynamics_params else {}
+
             target_layer.neurons.append(neuron)
             new_neurons.append(neuron)
 
@@ -260,21 +270,55 @@ class Nnet:
             if not all_candidates:
                 continue
 
-            total = len(all_candidates)
+            forced: list[tuple[Neuron, Neuron, ConnectionType]] = []
+
+            # --------------------------------------------------------------
+            # IO enforcement
+            # --------------------------------------------------------------
+
+            if require_io_connections and max_connections > 0:
+                incoming_candidates = [
+                    (src, dst, ctype) for src, dst, ctype in all_candidates if dst is n
+                ]
+
+                outgoing_candidates = [
+                    (src, dst, ctype) for src, dst, ctype in all_candidates if src is n
+                ]
+
+                # Enforce incoming if possible
+                if incoming_candidates:
+                    forced.append(random.choice(incoming_candidates))
+
+                # Enforce outgoing if possible and budget allows
+                if outgoing_candidates and len(forced) < max_connections:
+                    forced.append(random.choice(outgoing_candidates))
 
-            # Global connection budget based on density
+            # --------------------------------------------------------------
+            # Remaining
+            # --------------------------------------------------------------
+
+            total = len(all_candidates)
             k = int(np.ceil(total * connection_density))
-            k = min(k, max_connections)
+            k = min(k, max_connections - len(forced))
             k = max(k, 0)
 
+            remaining_candidates = [c for c in all_candidates if c not in forced]
+
+            # Create forced connections
+            for src, dst, ctype in forced:
+                self.add_connection(src, dst, weight=weight, conn_type=ctype)
+
+            k = min(k, len(remaining_candidates))
+
             if k == 0:
                 continue
 
-            # Randomly select k connections across all types
-            selected = random.sample(all_candidates, k)
+            sampled = random.sample(remaining_candidates, k)
 
-            # Create the selected connections
-            for src, dst, ctype in selected:
+            # --------------------------------------------------------------
+            # Create connections
+            # --------------------------------------------------------------
+            for src, dst, ctype in forced + sampled:
                 self.add_connection(src, dst, weight=weight, conn_type=ctype)
 
         return new_neurons
@@ -374,7 +418,7 @@ class Nnet:
             for n in layer.neurons:
                 if n.activation_name != "softmax":
                     total = n.input + n.bias
-                    n.output = n.activation(total)
+                    n.output = n.compute_output(total)
 
             # Propagate to targets (exclude recurrent edges)
             for n in layer.neurons:

{evonet-0.1.0.dev23 → evonet-0.1.0.dev25}/evonet/mutation.py

@@ -273,6 +273,8 @@ def add_random_neuron(
     connection_scope: Literal["adjacent", "crosslayer"] = "adjacent",
     connection_density: float = 1.0,
     max_connections: int = 2**63 - 1,
+    dynamics_name: str = "standard",
+    dynamics_params: dict[str, float] = {},
 ) -> Neuron | None:
     """
     Insert a new hidden neuron into a random layer.
@@ -313,6 +315,8 @@ def add_random_neuron(
         connection_scope=connection_scope,
         connection_density=connection_density,
         max_connections=max_connections,
+        dynamics_name=dynamics_name,
+        dynamics_params=dynamics_params,
     )[0]
 
     return new_neuron

{evonet-0.1.0.dev23 → evonet-0.1.0.dev25}/evonet/neuron.py

@@ -55,6 +55,41 @@ class Neuron:
         self.last_output: float = 0.0
         self.label = label
 
+        # Neuron dynamics (stateful behaviour over time)
+        self.dynamics_name: str = "standard"
+        self.dynamics_params: dict[str, float] = {}
+
+    def compute_output(self, total_input: float) -> float:
+        """
+        Compute the neuron's output given the total input.
+
+        This method defines the neuron's local output dynamics and serves as the single
+        extension point for experimental neuron behaviour (e.g. leaky integration,
+        gating, oscillators).
+
+        By default, this applies the activation function directly.
+        """
+
+        # Default / standard dynamics
+        if self.dynamics_name == "standard":
+            return self.activation(total_input)
+
+        # Leaky integrator dynamics
+        if self.dynamics_name == "leaky":
+            alpha = self.dynamics_params.get("alpha", 1.0)
+
+            # Safety: keep alpha in [0, 1]
+            if alpha < 0.0:
+                alpha = 0.0
+            elif alpha > 1.0:
+                alpha = 1.0
+
+            raw = self.activation(total_input)
+            return (1.0 - alpha) * self.last_output + alpha * raw
+
+        # Fallback: unknown dynamics --> behave like standard
+        return self.activation(total_input)
+
     def reset(self, full: bool = False) -> None:
         """
         Clear current neuron state for a new forward pass.

{evonet-0.1.0.dev23 → evonet-0.1.0.dev25}/evonet.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: evonet
-Version: 0.1.0.dev23
+Version: 0.1.0.dev25
 Summary: Evolvable neural network core for integration with EvoLib
 Author-email: EvoLib <evolib@dismail.de>
 License: MIT License
@@ -50,30 +50,54 @@ Requires-Dist: myst-parser; extra == "docs"
 Dynamic: license-file
 
 # EvoNet
+
 [![Code Quality & Tests](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml/badge.svg)](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Project Status: Alpha](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/EvoLib/evo-net)
 
-**EvoNet** is a modular and evolvable neural network core designed for integration with [EvoLib](https://github.com/EvoLib/evo-lib).
-It supports dynamic topologies, recurrent connections, per-neuron activation, and structural evolution – with a strong emphasis on **clarity**, **transparency**, and **didactic value**.
+**EvoNet** is a modular and evolvable neural network core designed for integration
+with [EvoLib](https://github.com/EvoLib/evo-lib).  
+It supports dynamic topologies, recurrent connections, per-neuron activation, and
+structural evolution, with a strong emphasis on clarity and explicit behaviour.
+
+---
+
+## Scope
+
+EvoNet is not a state-of-the-art or general-purpose deep learning framework.
+
+It does not aim to compete with libraries such as PyTorch, TensorFlow, or JAX in terms
+of performance, scalability, or training algorithms. Backpropagation, GPU acceleration,
+and highly optimised tensor operations are outside the scope of this project.
+
+Instead, EvoNet is designed for evolutionary algorithms, structural mutation, and
+exploratory research, with a focus on transparent and explicit implementations rather
+than performance optimisation or feature completeness.
+
+EvoNet should be understood as a conceptual and experimental model, not as a
+production-grade neural-network engine.
 
 ---
 
 ## Features
 
-- **Layer-based but flexible** – allows skip connections, cycles, and recurrent paths
+- **Explicit, layer-based topology** with support for skip connections, cycles,
+  and recurrent paths
 - **Typed neuron roles and connection types** (`NeuronRole`, `ConnectionType`)
-- **Topology-aware mutation system** – add/remove neurons and connections, mutate weights, change activations
-- **Per-neuron activation functions** – configurable, extensible, evolvable
-- **1-step recurrent state logic** – avoids multi-pass stabilization
-- **Topology can grow at runtime** – with `add_neuron`, `add_connection`, `split_connection`
-- **Debug-friendly architecture** – explicit IDs, labels, roles, directional graphs
-- **Designed for evolutionary learning** – mutation, crossover, speciation ready
-- **Lightweight & extensible** – pure Python, NumPy-based, no hard dependencies
+- **Topology-aware mutation operations**:
+  add/remove neurons and connections, mutate weights, change activations
+- **Per-neuron activation functions**, configurable and evolvable
+- **Explicit 1-step recurrent state model**, without iterative stabilisation passes
+- **Runtime topology growth**, e.g. via `add_neuron` and `add_connection`
+- **Debug-friendly architecture** with explicit neuron IDs, labels, roles,
+  and directional graphs
+- **Designed for evolutionary integration**, not gradient-based training
+- **Lightweight and extensible**: pure Python, NumPy-based, no hard dependencies
 
 ---
 
-> ⚠️ **This project is in early development (alpha)**. Interfaces and structure may change.
+> ⚠️ **Project status: Alpha**  
+> Interfaces, APIs, and internal structure may change as the project evolves.
 
 ---
 
@@ -83,14 +107,15 @@ It supports dynamic topologies, recurrent connections, per-neuron activation, an
 from evonet.core import Nnet
 
 net = Nnet()
-net.add_layer()  # Input
-net.add_layer()  # Output
+net.add_layer()  # Input layer
+net.add_layer()  # Output layer
 
-net.add_neuron(layer_idx=0, activation="linear", lable="in")
-net.add_neuron(layer_idx=1, activation="linear", bias=0.5, lable="out", connect_layer=True)
+net.add_neuron(layer_idx=0, activation="linear", label="in")
+net.add_neuron(layer_idx=1, activation="linear", bias=0.5, label="out")
 
 print(net.calc([1.0]))
 ```
+---
 
 ## License
 

{evonet-0.1.0.dev23 → evonet-0.1.0.dev25}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "evonet"
-version = "0.1.0.dev23"
+version = "0.1.0.dev25"
 description = "Evolvable neural network core for integration with EvoLib"
 authors = [
     { name = "EvoLib", email = "evolib@dismail.de" }

evonet-0.1.0.dev23/README.md

@@ -1,47 +0,0 @@
-# EvoNet
-[![Code Quality & Tests](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml/badge.svg)](https://github.com/EvoLib/evo-net/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Project Status: Alpha](https://img.shields.io/badge/status-alpha-orange.svg)](https://github.com/EvoLib/evo-net)
-
-**EvoNet** is a modular and evolvable neural network core designed for integration with [EvoLib](https://github.com/EvoLib/evo-lib).
-It supports dynamic topologies, recurrent connections, per-neuron activation, and structural evolution – with a strong emphasis on **clarity**, **transparency**, and **didactic value**.
-
----
-
-## Features
-
-- **Layer-based but flexible** – allows skip connections, cycles, and recurrent paths
-- **Typed neuron roles and connection types** (`NeuronRole`, `ConnectionType`)
-- **Topology-aware mutation system** – add/remove neurons and connections, mutate weights, change activations
-- **Per-neuron activation functions** – configurable, extensible, evolvable
-- **1-step recurrent state logic** – avoids multi-pass stabilization
-- **Topology can grow at runtime** – with `add_neuron`, `add_connection`, `split_connection`
-- **Debug-friendly architecture** – explicit IDs, labels, roles, directional graphs
-- **Designed for evolutionary learning** – mutation, crossover, speciation ready
-- **Lightweight & extensible** – pure Python, NumPy-based, no hard dependencies
-
----
-
-> ⚠️ **This project is in early development (alpha)**. Interfaces and structure may change.
-
----
-
-## Quick Example
-
-```python
-from evonet.core import Nnet
-
-net = Nnet()
-net.add_layer()  # Input
-net.add_layer()  # Output
-
-net.add_neuron(layer_idx=0, activation="linear", lable="in")
-net.add_neuron(layer_idx=1, activation="linear", bias=0.5, lable="out", connect_layer=True)
-
-print(net.calc([1.0]))
-```
-
-## License
-
-MIT License - see [MIT License](https://github.com/EvoLib/evo-net/tree/main/LICENSE).
-