explaingit

nohn3043-arch/anthropomorphic-agent-engine

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · easy

TLDR

A small Python engine that simulates emotional states, memory, and trauma for AI characters using simple numeric inputs.

Mindmap

mindmap
  root((Anthropomorphic-Agent-Engine))
    What it does
      Simulates emotional states
      Models memory and forgetting
      Tracks trauma and trust
    Tech stack
      Python
    Use cases
      Give game NPCs long term memory
      Build believable virtual assistants
      Run psychological simulation research
    Audience
      Game developers
      AI researchers
    Concepts
      Personality mapper
      Forgetting curve
      Suppression and rebound

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give a game NPC emotional inertia and long term memory that fades naturally over time.

USE CASE 2

Build a digital human or virtual assistant with believable emotional rapport.

USE CASE 3

Simulate trauma recovery or intervention scenarios for psychological research.

What is it built with?

Python

How does it compare?

nohn3043-arch/anthropomorphic-agent-engine0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

In plain English

This project is a small Python engine that simulates the shape of an emotional personality without knowing anything about the meaning of events. It takes in three simple numbers representing threat, belonging, and fatigue, and turns them into changing emotional states, memories that fade over time, and lasting trauma markers, purely through math. The README describes the core as the body, and says the meaning behind events, such as deciding that criticism feels threatening, is supplied separately by a small piece of code called a mapper. Inside the core, seven emotional dimensions such as joy, anger, fear, and trust drift toward changing targets over time, at a pace the code calls viscosity. If threat crosses a certain level, a trauma marker forms and biases future emotional reactions. Memories fade using a mathematical decay curve, with a limit of 64 stored memory traces, and older or less important ones get replaced. Suppressed negative emotions can build up and eventually burst out after a cooldown period, and a character's ability to trust can shrink after repeated negative experiences, recovering only slowly afterward. Developers customize a character's personality by writing their own mapper, a small class that decides what each named event, like praise or criticism, means in terms of threat and belonging. Swapping mappers changes how a character reacts while the underlying engine stays the same. The engine has no external dependencies beyond plain Python, works the same way every time given the same input, and is meant to be used for things like game characters with long term memory, virtual assistants, interactive storytelling, and psychological simulation research.

Copy-paste prompts

Prompt 1
Walk me through calling process_vector on this engine with a sample threat and belonging input.
Prompt 2
Explain how the forgetting curve and the 64 trace memory limit work together.
Prompt 3
Help me write a custom mapper class that defines what praise and criticism mean for my character.
Prompt 4
How does trust capacity erosion and recovery work in this engine?

Frequently asked questions

What is anthropomorphic-agent-engine?

A small Python engine that simulates emotional states, memory, and trauma for AI characters using simple numeric inputs.

What language is anthropomorphic-agent-engine written in?

Mainly Python. The stack also includes Python.

How hard is anthropomorphic-agent-engine to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is anthropomorphic-agent-engine for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.