FEAGI Evolution & Genome Management

Handles all genotype operations for FEAGI:

• Genome I/O (JSON ↔ Rust structs)
• Genome validation
• Evolution operators (mutation, crossover)
• Fitness evaluation
• Population management

Architecture

This crate manages the genetic blueprint (genotype) of FEAGI brains. The actual instantiated brain structure (phenotype) is handled by feagi-bdu.

Separation of Concerns

feagi-evo (Genotype)        feagi-bdu (Phenotype)
─────────────────────       ─────────────────────
│ Genome JSON I/O    │  →   │ Neuroembryogenesis │
│ Genome Validation  │      │ Connectome I/O      │
│ Evolution Ops      │      │ Synaptogenesis      │
│ Fitness Eval       │      │ NPU Integration     │
└────────────────────┘      └─────────────────────┘

Modules

• genome - Genome I/O and validation
• evolution - Evolution operators (future)
• fitness - Fitness evaluation (future)
• population - Population management (future)

Copyright 2025 Neuraville Inc. Licensed under the Apache License, Version 2.0

feagi-evolutionary

Evolution and genome management for FEAGI - genotype operations.

Overview

Handles genome (brain definition) I/O and manipulation:

• Genome loading and saving
• Genotype validation
• Cortical area parsing
• Genome migration between versions

Installation

[dependencies]
feagi-evolutionary = "2.0"

Usage

use feagi_evolutionary::genome::{load_genome, save_genome};

// Load brain definition from JSON
let genome = load_genome("path/to/genome.json")?;

Use Cases

• Development-time genome editing
• Brain configuration management
• NOT needed at runtime (use feagi-connectome-serialization instead)

Part of the FEAGI ecosystem.