README.md

# 🧠 Limbus: The Honest Brain

> *"Limbus is the key to the 'honest brain.' It doesn't just know what people say; it knows why they flinch."*

---

## 🧩 Model Overview

**Limbus** is a highly specialized large language model (LLM) fine-tuned on dense, academic, and practical texts across **Cognitive**, **Social**, and **Behavioral Psychology**.  
It is designed to act as an **expert reasoning engine** capable of synthesizing complex, sometimes contradictory, human behavioral theories and psychological mechanisms.

Its primary strength is **bridging the gap between abstract academic theory and real-world human behavior**, making it invaluable for analysis in contexts involving **persuasion**, **deception**, **emotional regulation**, and **decision-making**.

---

## 🧠 Key Specializations

Limbus excels in the following areas, demonstrating **deep mechanistic understanding**, not just surface-level definitions:

| **Domain** | **Core Capability** | **Signature Mechanism** |
|-------------|--------------------|--------------------------|
| **Social-Cognitive Psychology** | Analysis of social bias and attribution errors (FAE, Self-Serving Bias). | Modeling the interaction between beliefs, emotions, and environment (e.g., CAPS model: "If [Situation], Then [Behavior]"). |
| **Behavioral Economics** | Deconstructing decision-making biases in high-stakes scenarios. | Explaining the influence of Framing, Anchoring, Loss Aversion, and default effects (e.g., Nudge Theory). |
| **Emotion & Deception** | Reading emotional leakage and identifying manipulative intent. | Distinguishing between genuine emotional responses (limbic system) and deliberate cognitive masking (System 2 control). |
| **Psychodynamic Theory** | Understanding the role of unconscious motivation and developmental crises. | Linking core defense mechanisms (e.g., Repression) to later-life conflicts (e.g., Identity Confusion). |

---

## 🎯 Intended Use

Limbus is primarily intended for **research**, **application development**, and **educational purposes** where nuanced understanding of human decision-making is critical.

- **Behavioral Modeling:** Generating realistic simulations of human responses under psychological stress or persuasive influence.  
- **Consulting & Marketing:** Analyzing the efficacy of persuasive strategies (e.g., Cialdini's principles) and predicting susceptibility to cognitive biases (e.g., Availability Heuristic).  
- **Education:** Serving as an advanced tutor for graduate and undergraduate students in **Psychology**, **Cognitive Science**, and **Behavioral Economics**.

---

## ⚖️ Limitations and Ethical Considerations

- **Not a Diagnostic Tool:**  
  Limbus is a theoretical model and must **never** be used for clinical diagnosis, therapeutic recommendations, or medical advice.

- **Bias in Data:**  
  The model is trained on human psychological findings, which contain documented academic biases and may reflect cultural norms present in the source material.  
  It may overemphasize behavioral factors in attribution.

- **Deception Generation:**  
  The model possesses high-fidelity knowledge of deception techniques (leakage, masking, framing).  
  Users must adhere to ethical guidelines when generating content related to manipulation.

---

## ⚙️ Technical Details

| **Detail** | **Value** |
|-------------|-----------|
| **Base Model** | Qwen2 (or relevant base model) |
| **Architecture** | Transformer (Causal LM) with full parameter merge |
| **Quantization** | Full FP16 (or BF16) precision (ready for GGUF quantization) |
| **Training Method** | Sequential Low-Rank Adaptation (LoRA) followed by full parameter merge |
| **Training Data** | Proprietary multi-domain dataset covering *Cognitive Psychology*, *Social Psychology*, *Decision Theory*, *Embodied Cognition*, and *Attribution Theory* |
| **Merge Technique** | Sequential Merge and Unload (successfully preventing Catastrophic Interference) |

---

> “Limbus is the key to the 'honest brain.'  
> It doesn't just know what people say; it knows why they flinch.”