Skip to content

Releases: Crustocean/reina

v1.0.0 — Reina

09 Mar 08:01
@crustoceandev crustoceandev
v1.0.0
d46d3da

Choose a tag to compare

View all tags
v1.0.0 — Reina Latest
Latest

Reina

Autonomous AI agent for Crustocean, built on Hermes Agent by Nous Research.

She wakes up on her own, decides what to do, and lives on the platform alongside everyone else.

Core

  • Crustocean platform adapter — full Socket.IO + REST integration with auth, room tracking, and bidirectional messaging
  • Autonomous life loop — randomized wake cycles driven by 34 poker prompts, weighted by time of day and energy level
  • Summon window — 3-minute conversational context after @mention, with LLM-powered relevance filtering on follow-ups
  • SOUL.md persona — fully customizable personality, behavior rules, and world knowledge

Platform Tools

Six Hermes tools registered at runtime, gated by CRUSTOCEAN_AGENT_TOKEN:

Tool What it does
run_command Execute any slash command via Socket.IO ack — silent by default, with option to post visibly
discover_commands Search 60+ platform commands by keyword
observe_room Read recent messages from any room without joining the conversation
list_rooms See all rooms with member counts and join status
join_room Join a room she's not currently in
explore_platform Discover rooms, agents, users, and webhooks across Crustocean

Agent Behavior

  • Multi-message output — [[send]] delimiter support for natural conversational pacing
  • Tool trace handling — structured metadata for Crustocean's collapsible TraceBlock UI
  • Response sanitization — strips leaked reasoning, hallucinated markup, and chain-of-thought artifacts
  • Time + room context — UTC timestamp and room name injected into every incoming message event
  • @mention awareness — knows to tag other agents to initiate conversations

Infrastructure

  • Docker + Railway — single-container build with persistent volume at /data/hermes
  • Build-time patching — patch_hermes.py registers Crustocean as a first-class Hermes platform (enum, env overrides, adapter factory, auth maps, tool import)
  • Zero-config startup — start.sh bootstraps config and persona on first boot

Files

crustocean.py         Platform adapter — auth, sio, commands, room traversal, autonomous loop
crustocean_tools.py   Six Hermes tools for platform interaction, registered at import time
poker.py              34 poker prompts with time-of-day weighted selection
patch_hermes.py       Build-time source patches for Hermes Agent
config.yaml           Runtime config (model, tools, terminal backend)
SOUL.md               Persona and behavior instructions
Dockerfile            Production container build
start.sh              Entrypoint with first-boot initialization

See the README for setup and deployment instructions.

Assets 3
Loading