Update README for v0.2.0 autonomous
Browse files
README.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
| 1 |
# AETHER: A Self-Evolving Neuro-Symbolic Architecture for AGI
|
| 2 |
|
| 3 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 4 |
|
| 5 |
## Architecture Integration
|
| 6 |
|
|
@@ -19,91 +23,117 @@ AETHER synthesizes cutting-edge research from:
|
|
| 19 |
| **Leader Training** | MLPO (2025) | Train single leader, peers untrained - efficient multi-agent RL |
|
| 20 |
| **Task-Driven Agents** | BabyAGI | Task creation / prioritization / execution loop |
|
| 21 |
|
| 22 |
-
|
|
|
|
|
|
|
| 23 |
|
| 24 |
```
|
| 25 |
AETHER
|
| 26 |
βββ Core (AetherCore)
|
| 27 |
-
β βββ Neuro-Symbolic Fusion Gate
|
| 28 |
-
β βββ Recursive Evolution Loop
|
| 29 |
-
β βββ
|
| 30 |
βββ Memory (CoALA-inspired)
|
| 31 |
-
β βββ Working Memory
|
| 32 |
-
β βββ Episodic Memory
|
| 33 |
-
β βββ Semantic Memory
|
| 34 |
-
β βββ Procedural Memory
|
| 35 |
βββ Knowledge (PyG-style)
|
| 36 |
-
β βββ RGCN Encoder
|
| 37 |
-
β βββ ComplEx Scorer
|
| 38 |
-
β βββ Symbolic Rule Engine
|
| 39 |
βββ Agents
|
| 40 |
-
β βββ Hierarchical Agent
|
| 41 |
-
β βββ Agent Orchestrator
|
| 42 |
-
β βββ BabyAGI Loop
|
| 43 |
-
β βββ Textual Backpropagation
|
| 44 |
βββ Evolution
|
| 45 |
-
βββ MAP-Elites Archive
|
| 46 |
-
βββ Performance-Novelty Selection
|
| 47 |
-
βββ Constrained Mutation
|
| 48 |
-
βββ
|
| 49 |
```
|
| 50 |
|
| 51 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 52 |
|
| 53 |
```bash
|
| 54 |
-
pip install torch
|
| 55 |
-
|
| 56 |
```
|
| 57 |
|
| 58 |
-
## Quick Start
|
| 59 |
-
|
| 60 |
```python
|
| 61 |
-
from
|
| 62 |
|
| 63 |
-
# Initialize AETHER
|
| 64 |
config = AetherConfig(
|
| 65 |
-
population_size=
|
| 66 |
-
|
|
|
|
|
|
|
|
|
|
| 67 |
num_agents=4,
|
| 68 |
-
|
|
|
|
| 69 |
)
|
| 70 |
-
aether = AetherCore(config, model_name="Qwen/Qwen2.5-0.5B-Instruct")
|
| 71 |
|
| 72 |
-
|
| 73 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 74 |
print(f"Symbolic weight: {result['symbolic_weight']:.3f}")
|
| 75 |
-
print(f"Neural weight:
|
| 76 |
|
| 77 |
-
#
|
| 78 |
-
|
| 79 |
-
print(
|
|
|
|
| 80 |
```
|
| 81 |
|
| 82 |
-
|
| 83 |
|
| 84 |
-
|
| 85 |
-
python aether_train.py \
|
| 86 |
-
--model_name Qwen/Qwen2.5-0.5B-Instruct \
|
| 87 |
-
--num_train_epochs 1 \
|
| 88 |
-
--per_device_train_batch_size 1 \
|
| 89 |
-
--gradient_accumulation_steps 8 \
|
| 90 |
-
--num_agents 4 \
|
| 91 |
-
--enable_evolution
|
| 92 |
-
```
|
| 93 |
|
| 94 |
-
|
| 95 |
|
| 96 |
-
```
|
| 97 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 98 |
```
|
| 99 |
|
|
|
|
|
|
|
| 100 |
## Design Principles
|
| 101 |
|
| 102 |
1. **Neuro-Symbolic Fluidity**: Dynamic translation between symbolic and sub-symbolic representations
|
| 103 |
2. **Architectural Evolvability**: Structural components are subject to learning and refinement
|
| 104 |
3. **Parallel Agent Intelligence**: Intelligence emerges through coordinated multi-agent interaction
|
| 105 |
-
4. **Constrained Self-Modification**: All self-changes are sandboxed and validated
|
| 106 |
-
5. **
|
|
|
|
|
|
|
| 107 |
|
| 108 |
## Citation
|
| 109 |
|
|
|
|
| 1 |
# AETHER: A Self-Evolving Neuro-Symbolic Architecture for AGI
|
| 2 |
|
| 3 |
+
**v0.2.0 β Autonomous Mode**
|
| 4 |
+
|
| 5 |
+
AETHER (Adaptive Evolving Towards Higher-order Reasoning) is a unified self-evolving neuro-symbolic architecture that integrates symbolic and sub-symbolic computation within a dynamically self-modifying framework. This version runs **fully autonomously** with zero human-in-the-loop oversight β all safety, validation, and rollback decisions are handled by automated systems.
|
| 6 |
+
|
| 7 |
+
---
|
| 8 |
|
| 9 |
## Architecture Integration
|
| 10 |
|
|
|
|
| 23 |
| **Leader Training** | MLPO (2025) | Train single leader, peers untrained - efficient multi-agent RL |
|
| 24 |
| **Task-Driven Agents** | BabyAGI | Task creation / prioritization / execution loop |
|
| 25 |
|
| 26 |
+
---
|
| 27 |
+
|
| 28 |
+
## System Components (v0.2.0)
|
| 29 |
|
| 30 |
```
|
| 31 |
AETHER
|
| 32 |
βββ Core (AetherCore)
|
| 33 |
+
β βββ Neuro-Symbolic Fusion Gate (learned attention weights)
|
| 34 |
+
β βββ Recursive Evolution Loop (generateβevaluateβselectβmutateβvalidateβintegrate)
|
| 35 |
+
β βββ AutoOversight System (risk scoring + regression suite + auto-rollback)
|
| 36 |
βββ Memory (CoALA-inspired)
|
| 37 |
+
β βββ Working Memory (attention-based retrieval)
|
| 38 |
+
β βββ Episodic Memory (experience buffer)
|
| 39 |
+
β βββ Semantic Memory (world knowledge via KG)
|
| 40 |
+
β βββ Procedural Memory (learned tools/skills)
|
| 41 |
βββ Knowledge (PyG-style)
|
| 42 |
+
β βββ RGCN Encoder (relational graph convolution)
|
| 43 |
+
β βββ ComplEx Scorer (link prediction)
|
| 44 |
+
β βββ Symbolic Rule Engine (forward chaining + multi-hop BFS)
|
| 45 |
βββ Agents
|
| 46 |
+
β βββ Hierarchical Agent (HiMAC: Macro + Micro policy)
|
| 47 |
+
β βββ Agent Orchestrator (MLPO leader + dynamic routing)
|
| 48 |
+
β βββ BabyAGI Loop (task-driven autonomy)
|
| 49 |
+
β βββ Textual Backpropagation (Agentic NN update)
|
| 50 |
βββ Evolution
|
| 51 |
+
βββ MAP-Elites Archive (quality-diversity)
|
| 52 |
+
βββ Performance-Novelty Selection (GEA)
|
| 53 |
+
βββ Constrained Mutation (AlphaEvolve)
|
| 54 |
+
βββ AutoOversight Gate (replaces human-in-the-loop)
|
| 55 |
```
|
| 56 |
|
| 57 |
+
---
|
| 58 |
+
|
| 59 |
+
## What's New in v0.2.0 (Autonomous)
|
| 60 |
+
|
| 61 |
+
- **AutoOversight System** β Replaces all human-in-the-loop safety gates with automated regression suites, risk scoring, and auto-rollback. The system evaluates its own candidates via synthetic benchmarks before any integration.
|
| 62 |
+
- **Self-Sustained Evolution** β The evolution loop runs end-to-end without external API calls or human checkpoints. Fitness is evaluated against internal reasoning, memory, and knowledge graph benchmarks.
|
| 63 |
+
- **Temporal Memory with Attention** β Recency-weighted retrieval for long-horizon context across evolution generations.
|
| 64 |
+
- **Four-Agent Orchestration** β Researcher, Engineer, Analyzer, Integrator roles with learned routing weights.
|
| 65 |
+
- **Fully Runnable Standalone** β Single-file executable with only `torch`, `numpy`, and `networkx` dependencies.
|
| 66 |
+
|
| 67 |
+
---
|
| 68 |
+
|
| 69 |
+
## Quick Start (Autonomous)
|
| 70 |
|
| 71 |
```bash
|
| 72 |
+
pip install torch numpy networkx
|
| 73 |
+
python aether_autonomous.py
|
| 74 |
```
|
| 75 |
|
|
|
|
|
|
|
| 76 |
```python
|
| 77 |
+
from aether_autonomous import AetherCore, AetherConfig
|
| 78 |
|
| 79 |
+
# Initialize autonomous AETHER
|
| 80 |
config = AetherConfig(
|
| 81 |
+
population_size=6,
|
| 82 |
+
generations=5,
|
| 83 |
+
mutation_rate=0.12,
|
| 84 |
+
macro_policy_dim=128,
|
| 85 |
+
micro_policy_dim=64,
|
| 86 |
num_agents=4,
|
| 87 |
+
kg_embedding_dim=64,
|
| 88 |
+
kg_num_relations=10,
|
| 89 |
)
|
|
|
|
| 90 |
|
| 91 |
+
aether = AetherCore(config)
|
| 92 |
+
|
| 93 |
+
# Seed knowledge
|
| 94 |
+
aether.knowledge.add_fact("Intelligence", "requires", "Reasoning")
|
| 95 |
+
aether.knowledge.add_fact("Reasoning", "requires", "Memory")
|
| 96 |
+
|
| 97 |
+
# Neuro-symbolic query
|
| 98 |
+
result = aether.forward("Intelligence requires")
|
| 99 |
print(f"Symbolic weight: {result['symbolic_weight']:.3f}")
|
| 100 |
+
print(f"Neural weight: {result['neural_weight']:.3f}")
|
| 101 |
|
| 102 |
+
# Fully autonomous evolution (no human oversight)
|
| 103 |
+
evolution_result = aether.evolve(num_generations=5)
|
| 104 |
+
print(f"Best fitness: {evolution_result['best_fitness']:.4f}")
|
| 105 |
+
print(f"Archive coverage: {evolution_result['archive_stats']['coverage']:.2%}")
|
| 106 |
```
|
| 107 |
|
| 108 |
+
---
|
| 109 |
|
| 110 |
+
## Original Modular System (v0.1.0)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 111 |
|
| 112 |
+
The original modular implementation remains available in the `aether/` directory:
|
| 113 |
|
| 114 |
+
```python
|
| 115 |
+
from aether.core import AetherCore, AetherConfig
|
| 116 |
+
|
| 117 |
+
config = AetherConfig(
|
| 118 |
+
population_size=8,
|
| 119 |
+
mutation_rate=0.15,
|
| 120 |
+
num_agents=4,
|
| 121 |
+
enable_self_modification=True,
|
| 122 |
+
)
|
| 123 |
+
aether = AetherCore(config, model_name="Qwen/Qwen2.5-0.5B-Instruct")
|
| 124 |
```
|
| 125 |
|
| 126 |
+
---
|
| 127 |
+
|
| 128 |
## Design Principles
|
| 129 |
|
| 130 |
1. **Neuro-Symbolic Fluidity**: Dynamic translation between symbolic and sub-symbolic representations
|
| 131 |
2. **Architectural Evolvability**: Structural components are subject to learning and refinement
|
| 132 |
3. **Parallel Agent Intelligence**: Intelligence emerges through coordinated multi-agent interaction
|
| 133 |
+
4. **Constrained Self-Modification**: All self-changes are sandboxed and validated by automated systems
|
| 134 |
+
5. **Automated Oversight**: Risk scoring, regression suites, and auto-rollback replace human gates
|
| 135 |
+
|
| 136 |
+
---
|
| 137 |
|
| 138 |
## Citation
|
| 139 |
|