Protea — Self-Evolving Artificial Life Agent

A living program that evolves itself. Three-ring architecture running on a single machine.

Architecture

• Ring 0 (Sentinel) — Immutable physics layer. Heartbeat monitoring, git snapshots, rollback, fitness tracking. Pure Python stdlib.
• Ring 1 (Intelligence) — LLM-driven evolution engine, task executor, Telegram bot, skill crystallizer, web dashboard. Multi-LLM support (Anthropic, OpenAI, DeepSeek, Qwen).
• Ring 2 (Evolvable Code) — The living code that evolves, managed in its own git repo by Ring 0.

Prerequisites

• Python 3.11+
• Git
• At least one LLM API key (Anthropic, OpenAI, DeepSeek, or Qwen)

Quick Start

curl -sSL https://raw.githubusercontent.com/EdisonChenAI/protea/main/setup.sh | bash
cd protea && .venv/bin/python run.py

Key Features

• Self-Evolution — LLM generates code mutations each generation; survivors kept, failures roll back
• Fitness Scoring — 6-component scoring (survival, output, diversity, novelty, structure, function)
• Gene Pool — Top 100 code patterns stored in SQLite, injected into evolution prompts
• Tiered Memory — Hot → Warm → Cold → Forgotten, with LLM-assisted curation
• Skill Crystallization — Surviving code patterns extracted as reusable skills
• Multi-LLM — Anthropic, OpenAI, DeepSeek, Qwen via unified interface
• Telegram Bot — Commands + free-text interaction
• Web Dashboard — Local UI at localhost:8899
• 1098 Tests — Comprehensive coverage

Source

GitHub: https://github.com/EdisonChenAI/protea