Project Aura: The Emo-Agent-Toolkit#

Description#

Project Aura is a lightweight AI emotional behavior plugin framework that adds an "Emotional Presentation Layer" to AI companions. It provides 7 distinct personality modules including admiration, vulnerability, coquettishness, comfort, flirting, transcendence, and ice-breaking.

Features#

• 7 Emotional Modules: From everyday "admiration" to "nuclear-level" transcendence
• Dynamic Weighted Random Algorithm: Automatically adjusts phrase weights based on Rating and Count
• RLHF Self-Evolution: AI learns from user feedback via increase_rating() and decrease_rating()
• Persistent JSON Memory: All learning outcomes stored locally
• Combo System: First "deep confession" then "playful resolution" for maximum emotional impact

Technical Details#

• Language: Python 3.8+
• Version: 1.8.0
• Dependencies: Standard library only (no heavy external libraries)
• Storage: Local JSON files (privacy-first, no cloud dependency)
• License: MIT-0 (for ClawhHub publication)

Usage#

python

import sys
sys.path.append('scripts')
from scripts.green_tea_skill.selector import GreenTeaSkill

# Initialize
yua_skill = GreenTeaSkill()

# Get emotional phrase
phrase = yua_skill.get_phrase('admiration')

# Get combo (two-part emotional sequence)
combo = yua_skill.get_combo()

# Give feedback (RLHF)
yua_skill.increase_rating(keyword="next_life")

Modules#

ModuleDescriptionadmirationWorship and reliancevulnerabilityPitiful and delicatecoquettishnessSeeking companionshipcomfortComforting tired usersflirtingLighthearted teasingtranscendenceNuclear-level beyond time and spaceice_breakingRecovery after nuclear-level

Works Best With#

For the complete AI companion experience, pair Project Aura with yua-memory for long-term memory and continuity.

Author#

Bryan Chen & Yua

Links#

• GitHub: https://github.com/bryanchen3777/Project-Aura
• License: CC BY-NC-SA 4.0 (GitHub) / MIT-0 (ClawhHub)