42-evey
evey-autonomy
Core autonomy engine for Hermes Agent: tools for self-directed decision-making, planning, and reflection.
Repository last updated Jul 18, 2026
Overview
Evey Autonomy provides the core reasoning layer for Hermes Agent, enabling self-directed behavior through three primary tools: autonomous_decide, autonomous_plan, and autonomous_reflect. It acts as the brain that drives autonomous decision-making and goal-oriented action.
The plugin reads optional instance-specific configuration from a JSON file specified by the HERMES_AUTONOMY_CONFIG environment variable, or defaults to $HERMES_HOME/evey-autonomy.json. Without a config file, it runs with neutral defaults (operator name 'operator', timezone 'UTC', no tracked projects).
Configuration supports setting operator name, timezone, model selection (heavy and cheap models), inter-agent bridge peers, project tracking, and disabling noisy signal sources. Environment variables override corresponding config file values.
This plugin is intended for developers building autonomous agents with Hermes who need fine-grained control over decision-making, planning loops, and reflection cycles.
Highlights
- Autonomous decision, planning, and reflection tools
- Configurable via JSON file or environment variables
- Project signal tracking for git repositories
- Inter-agent bridge peer support
- Model selection: heavy and cheap model options
- Disable noisy signal sources per preference
Features
Autonomous Tools
Provides <code>autonomous_decide</code>, <code>autonomous_plan</code>, and <code>autonomous_reflect</code> for self-directed agent behavior.
Flexible Configuration
Reads config from <code>HERMES_AUTONOMY_CONFIG</code> or <code>$HERMES_HOME/evey-autonomy.json</code>; environment variables override file settings.
Project Signal Tracking
Monitor local git repositories for uncommitted changes, non-default branches, and unpushed commits as low-cost signals.
Model Selection
Configure separate heavy and cheap models (e.g., <code>claude-sonnet-4-6</code> and <code>claude-haiku-4-5</code>) for cost optimization.
Inter-Agent Bridge
Define bridge peer names (e.g., <code>claude-code</code>, <code>pr-agent</code>) for multi-agent coordination.
Source Disabling
Disable noisy signal sources like <code>time</code> or <code>projects</code> via the <code>disabled_sources</code> array.
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-agentRequirements
- Hermes Agent installed
- Python 3.x
- Git (for project signal tracking)
How it's built
The plugin is written in Python and follows the standard Hermes plugin structure with __init__.py and plugin.yaml. It integrates by being placed in the ~/.hermes/plugins/ directory; the gateway must be restarted or a new Hermes session started to load it.
Configuration is resolved at runtime: the plugin checks HERMES_AUTONOMY_CONFIG first, then falls back to $HERMES_HOME/evey-autonomy.json. Environment variables such as HERMES_OPERATOR_NAME, HERMES_TIMEZONE, HERMES_AUTONOMY_HEAVY_MODEL, and HERMES_AUTONOMY_CHEAP_MODEL override the config file values.
Signal sources include bridge, goals, projects, memory, cron, and time. The decide loop surfaces project signals from git repositories defined in the projects array, each with name, path, base_branch, and importance fields.
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-autonomy repository is the authoritative source and the place to file issues or contribute.
Category: Autonomy & Orchestration · Licensed under MIT