Bhava

Bhava (Sanskrit: भाव — emotion, feeling, state of being) — emotion and personality engine for AGNOS

Shared personality and emotional state system for AI agents, game NPCs, and any entity that needs expressive behavior. Extracted from SecureYeoman's soul/brain architecture.

15-trait personalities, PAD mood vectors, cosine similarity, sentiment analysis, identity archetypes, relationship graphs, energy/circadian/flow systems, EQ, cultural display rules, ACT-R activation, preference learning, belief system, intuition engine, aesthetic attribution, psychology math bridge (bodh), sociology math bridge (sangha), physiology bridge (sharira), microbiology bridge (jivanu) — zero unsafe, 4 core deps, 1117 tests.

Installation

[dependencies]
bhava = "1.0"

Default features: traits, mood, archetype, sentiment.

Optional: presets, ai, sqlite, instinct, psychology, sociology, tracing.

MSRV: 1.89 (Rust edition 2024).

Features

Quick Start

use bhava::traits::{PersonalityProfile, TraitKind, TraitLevel};
use bhava::mood::{EmotionalState, Emotion};
use bhava::archetype::{compose_identity_prompt, IdentityContent, IdentityLayer};
use bhava::sentiment;

// Create a personality
let mut personality = PersonalityProfile::new("Guy");
personality.set_trait(TraitKind::Warmth, TraitLevel::Highest);
personality.set_trait(TraitKind::Humor, TraitLevel::High);
let prompt = personality.compose_prompt();

// Track emotional state
let mut state = EmotionalState::new();
state.stimulate(Emotion::Joy, 0.8);
state.stimulate(Emotion::Trust, 0.5);

// Analyze sentiment
let result = sentiment::analyze("This is wonderful work!");
assert!(result.is_positive());

// Compose identity prompt
let mut identity = IdentityContent::default();
identity.set(IdentityLayer::Soul, "You are an optimistic helper.");
let full_prompt = compose_identity_prompt(&identity);

Modules

Dependency Stack

┌─────────────────────────────────────────────────┐
│               CONSUMERS                          │
│  SecureYeoman / joshua / agnosai / hoosh         │
└──────────────────────┬──────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────┐
│                      BHAVA                            │
│  37 modules: traits, mood, belief, intuition...      │
├──────────────────────────────────────────────────────┤
│                   BRIDGE LAYER                        │
│  compat     psychology  sociology  physiology  micro  │
│  (jantu)    (bodh)      (sangha)   (sharira)  (jivanu)│
│  15 fn      14 fn       12 fn      12 fn      10 fn   │
└──┬──────────┬──────────┬──────────┬──────────┬───────┘
   │          │          │          │          │
┌──▼───┐ ┌───▼────┐ ┌───▼────┐ ┌───▼────┐ ┌──▼─────┐
│JANTU │ │ BODH   │ │SANGHA  │ │SHARIRA │ │JIVANU  │
│animal│ │ psych  │ │ socio  │ │ body   │ │ micro  │
└──────┘ └────────┘ └────────┘ └────────┘ └────────┘

Consumers

• SecureYeoman — agent personalities (T.Ron, Friday, etc.)
• joshua — NPC emotional states and personality-driven behavior
• agnosai — crew member personality differentiation and mood-driven temperature
• hoosh — response sentiment analysis

Documentation

• Architecture Overview — module map, data flows, design principles
• Mathematical Reference — all algorithms and formulas
• Usage Guide — patterns, philosophy, code examples
• Testing Guide — 1117 tests, testing patterns
• Roadmap — v1.0 status, future features
• Threat Model — attack surface, mitigations, privilege model
• Dependency Watch — dependency tracking and upgrade notes
• ADRs — architectural decision records
• Contributing — workflow, code style, testing requirements
• Security Policy — reporting, supported versions

License

GPL-3.0