README.md

---
title: AETHER v0.3.0
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
tags:
- ml-intern
---

# AETHER v0.3.0 — Autonomous Self-Evolving Architecture

A self-evolving neuro-symbolic architecture that runs **24/7 on HuggingFace Spaces**.
Evolves autonomously in a background thread, persists its full memory and knowledge 
graph state to the HF Hub, and executes reasoning tasks via REST API even when 
browser tabs are closed.

## Architecture

- **Neuro-Symbolic Fusion Gate** — learned attention over symbolic/neural split
- **4-Agent Orchestration** — Researcher, Engineer, Analyzer, Integrator with learned routing
- **MAP-Elites Quality-Diversity** — behavioral archive for evolutionary search
- **CoALA 4-Tier Memory** — Working, Episodic, Semantic, Procedural
- **Temporal Memory** — recency-weighted long-horizon context
- **Knowledge Graph** — RGCN + ComplEx + symbolic rule engine
- **AutoOversight** — automated regression gating + risk scoring + auto-rollback (zero human oversight)
- **Background Evolution** — continuous improvement in a daemon thread
- **State Persistence** — CommitScheduler auto-pushes checkpoints to `camdog920/aether-state`

## API Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/` | Gradio monitoring dashboard |
| GET | `/status` | Live system state |
| POST | `/task` | Submit async reasoning task |
| GET | `/task/{id}` | Get task result |
| POST | `/evolve` | Trigger 1 evolution cycle |
| GET | `/history` | Evolution trajectory |
| GET | `/kg` | Knowledge graph dump |
| POST | `/kg/fact` | Add fact to knowledge graph |
| POST | `/config` | Update evolution config |
| GET | `/snapshot` | Force save state |

## Environment Variables

- `HF_TOKEN` — Write-scoped token (set in Space secrets)
- `AETHER_STATE_REPO` — Model repo for state persistence (default: `camdog920/aether-state`)