Spaces:
Running
Running
File size: 2,715 Bytes
b2f6da7 7a4ccb2 b2f6da7 7a4ccb2 b2f6da7 7a4ccb2 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | ---
title: agent-loop — FORGE Self-Improvement Orchestrator
emoji: 🔄
colorFrom: blue
colorTo: red
sdk: docker
pinned: true
license: mit
short_description: Feedback loop — trace→learn→propose→approve→deploy
---
# 🔄 agent-loop
### FORGE Self-Improvement Orchestrator
Closes the feedback loop. Runs on a configurable cron interval, detects underperforming agents,
generates improved system prompts via NEXUS, creates drafts in agent-prompts, and notifies you
for approval. **Never auto-deploys — every change requires human approval.**
## Improvement pipeline
```
TRACE ──(events)──▶ LEARN ──(scored)──▶ LOOP
│
NEXUS ◀──(generate proposal)
│
PROMPTS ◀──(POST draft, status=draft)
│
RELAY ◀──(Telegram notify)
│
YOU ──(approve via dashboard or API)
│
PROMPTS persona updated → agents fetch at next startup
```
## Decision thresholds
| Condition | Action |
|-----------|--------|
| `avg_reward < REWARD_THRESHOLD (0.2)` | Generate improvement proposal |
| `error_rate > ERROR_ESCALATE (15%)` | Mark critical, escalate via RELAY |
| `reward_delta < 0.05` after 24h | Mark cycle inconclusive |
| `reward_delta > 0.05` after 24h | Mark cycle successful |
## REST API
```
POST /api/cycle Trigger a cycle manually
GET /api/cycles List recent cycles
GET /api/proposals List proposals (state, agent filters)
POST /api/proposals/{id}/approve Approve → deploy to agent-prompts
POST /api/proposals/{id}/reject Reject proposal
GET /api/health/agents Agent health snapshot
GET /api/stats Loop statistics
```
## MCP
```
GET /mcp/sse · POST /mcp
Tools: loop_status, loop_trigger, loop_proposals, loop_approve,
loop_reject, loop_health, loop_cycles
```
## Secrets
| Key | Description |
|-----|-------------|
| `LOOP_KEY` | Optional write auth (X-Loop-Key header) |
| `LEARN_URL` | `https://chris4k-agent-learn.hf.space` |
| `TRACE_URL` | `https://chris4k-agent-trace.hf.space` |
| `PROMPTS_URL` | `https://chris4k-agent-prompts.hf.space` |
| `NEXUS_URL` | `https://chris4k-agent-nexus.hf.space` |
| `RELAY_URL` | `https://chris4k-agent-relay.hf.space` |
| `CYCLE_MINUTES` | Default: `60` |
| `REWARD_THRESHOLD` | Default: `0.2` |
| `CYCLE_ENABLED` | Set `false` to pause |
Built by [Chris4K](https://huggingface.co/Chris4K) — ki-fusion-labs.de
|