42-evey

evey-identity

Self-updating SOUL.md that evolves an agent's personality based on interactions.

290 stars31 forksPythonMIT

Repository last updated Jul 18, 2026

Overview

Evey Identity is a plugin for the Hermes Agent ecosystem that introduces a self-updating personality document, SOUL.md. This file evolves over time as the agent interacts with users and environments, allowing the agent's character and behavior to adapt dynamically.

The plugin reads the current SOUL.md at startup, uses it to inform responses, and periodically updates the file based on conversation history and feedback. This creates a persistent, evolving identity that grows more nuanced with each interaction.

Designed for developers building autonomous or AI agents, Evey Identity enables more personalized and context-aware agent behaviors without manual reconfiguration.

Highlights

  • Self-updating personality document (SOUL.md)
  • Evolves agent character based on interactions
  • Persistent identity across sessions
  • Works with Hermes Agent ecosystem

Features

Self-Updating SOUL.md

Automatically rewrites the SOUL.md file to reflect new traits and memories from interactions.

Dynamic Personality Evolution

Agent's responses are influenced by its accumulated history, making it more adaptive over time.

Seamless Integration

Plug into Hermes Agent with minimal configuration; uses plugin.yaml for setup.

Installation

Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.

git clone https://github.com/42-evey/hermes-plugins.git
cp -r hermes-plugins/evey-* ~/.hermes/plugins/
cp hermes-plugins/evey_utils.py ~/.hermes/plugins/
# Restart hermes-agent

Requirements

  • Python 3.x
  • Hermes Agent installed

How it's built

The plugin is written in Python and follows the standard Hermes Agent plugin structure. The main logic resides in evey-identity/__init__.py, while evey-identity/plugin.yaml declares metadata and configuration. At runtime, the plugin loads SOUL.md from the agent's working directory, parses it for personality traits, and appends new observations after each interaction. The updated file is written back, ensuring persistence across restarts.

Integration requires only placing the plugin folder in the Hermes Agent plugins directory and enabling it via configuration. No external dependencies beyond Python are needed.

Source

This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The 42-evey/evey-identity repository is the authoritative source and the place to file issues or contribute.

Category: Memory & Knowledge · Licensed under MIT

Related Hermes plugins