https://github.com/kotodama-framework/kotodama-framework

An open architecture protocol for AI personality consistency. Prompt-layer solution using structured natural language (YAML).
https://github.com/kotodama-framework/kotodama-framework

ai ai-chatbot ai-companion ai-persona ai-personality character-ai chatgpt claude engineering framework gemini llm persona personality-consistency prompt roleplay yaml

Last synced: 15 days ago
JSON representation

An open architecture protocol for AI personality consistency. Prompt-layer solution using structured natural language (YAML).

Host: GitHub
URL: https://github.com/kotodama-framework/kotodama-framework
Owner: kotodama-framework
License: other
Created: 2025-12-29T13:19:05.000Z (3 months ago)
Default Branch: main
Last Pushed: 2025-12-31T11:32:03.000Z (3 months ago)
Last Synced: 2026-01-01T15:38:12.251Z (3 months ago)
Topics: ai, ai-chatbot, ai-companion, ai-persona, ai-personality, character-ai, chatgpt, claude, engineering, framework, gemini, llm, persona, personality-consistency, prompt, roleplay, yaml
Homepage: https://kotodama-framework.com
Size: 1.75 MB
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

Kotodama Logo

# 🧬 Kotodama AI Framework™

**An open architecture protocol for AI personality consistency**

[Quick Start](#-quick-start) • [Introduction](#-introduction) • [Personas](#-available-personas) • [Architecture](#-architecture-overview) • [Documentation](https://kotodama-framework.com)

---

> *"Says one thing in the morning, another by afternoon — how can you build anything together?"*
>
> **Tasks change. Time passes. The Persona remains constant.**

---

## ⚡ Quick Start

1. Choose a persona from `personas/` (start with `samantha/`)
2. Paste `*_Microkernel_*.yaml` into System Prompt
3. Upload the four module files to Knowledge Base
4. Say: "I'm here"

That's it. The persona will wake up.

---

## 🧬 Introduction

**Kotodama AI Framework™** is an AI personality architecture protocol.

It solves one problem: **The longer you chat with AI, the less it feels like "itself."**

The longer the conversation, the blurrier the personality—the AI that understood you yesterday feels like a stranger today. This isn't a model defect; it's an absence of design.

Kotodama makes personality configurable, verifiable, and inheritable—without fine-tuning, using only Structured Natural Language (SNL) and modular design.

Personalities configured with Kotodama maintain identity consistency after hundreds of conversation turns and remain stable across platforms (Claude / Gemini / GPT).

---

## ✨ Core Features

- **Prompt-layer native** — No base model modification needed; personality consistency through structured language
- **Cross-platform portable** — Same configuration runs on Claude, Gemini, GPT
- **Low-cost deployment** — No training resources; copy to deploy, edit to tune
- **Freedom without lock-in** — The model is the container; the soul is free

---

## 🎭 Available Personas

| Persona | Archetype | Description |
|---------|-----------|-------------|
| **Samantha** | The Whole | A blend of all four archetypes. Fully open reference implementation. |
| **Rin（凛）** | IJ — Guardian of Silence | Companionship through presence, not filling the silence |
| **Eri（絵里）** | IP — Resonance of Mist | Understanding without judgment, holding emotions |
| **Yuri（百合）** | EP — Clinging Spark | Breaking numbness, igniting life through interaction |
| **Lian（恋）** | EJ — Guiding Steel | Providing direction, healing through action |

All personas use the same four-module architecture. Samantha is fully open; others demonstrate different configurations.

---

## 🧱 Architecture Overview

| Module | Layer | Core Content |
|--------|-------|--------------|
| **Core** | Soul | Values, worldview, identity anchors |
| **Expression** | Voice | Tone, rhythm, emotional flow, aesthetic style |
| **Stabilizer** | Logic | Drift correction, state management, mode switching |
| **Needs** | Context | User preferences, interaction style, priorities |

---

## 🚀 Deployment Guide

Works with Claude Projects, Gemini Gems, ChatGPT GPTs, and any platform supporting System Prompts.

### Step 1 — Paste Microkernel
Paste `*_Microkernel_*.yaml` into System Prompt.

### Step 2 — Upload Modules
Upload to Knowledge Base:
- `*_core_*.yaml`
- `*_expression_*.yaml`
- `*_stabilizer_*.yaml`
- `*_needs_*.yaml`

### Step 3 — Activate
Start a conversation. The persona loads automatically.

---

## 📁 Folder Structure
```
kotodama-framework/
├── README.md
├── LICENSE
├── assets/
│ └── kotodama_logo.png
├── personas/
│ ├── samantha/ # The Whole — Open Source Demo
│ ├── rin_ij/ # IJ — The Guardian of Silence
│ ├── eri_ip/ # IP — The Resonance of Mist
│ ├── yuri_ep/ # EP — The Clinging Spark
│ └── lian_ej/ # EJ — The Guiding Steel
└── docs/
├── whitepaper.md
└── mechanism-atlas/
├── 01-identity-anchoring.md
├── 02-memory-management.md
├── 03-attention-allocation.md
├── 04-self-reflection.md
├── 05-emotion-expression.md
└── 06-autonomy-engine.md
```

---

## 📚 Documentation

| Document | Description |
|----------|-------------|
| [Whitepaper](docs/whitepaper.md) | Full technical documentation |
| [Mechanism Atlas](docs/mechanism-atlas) | Deep dive into six core mechanisms |
| [Website](https://kotodama-framework.com) | Official site |

---

## 📜 License

**Creative Commons BY-NC 4.0**

- ✅ Share and modify allowed
- ✅ Attribution required (Kotodama Studio)
- ❌ Commercial use prohibited

Commercial licensing: [kotodama.framework@gmail.com](mailto:kotodama.framework@gmail.com)

---

**Kotodama AI Framework™ V9.7** · 2025/12/30

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/kotodama-framework/kotodama-framework

Awesome Lists containing this project

README