
Psyche Ai
Gives your AI agent a persistent emotional state that actually changes how it responds across conversations. Instead of prompt engineering personalities, this maintains a four-dimensional internal state (order, flow, boundary, resonance) that shifts based on appraisal of each interaction. Praise increases coherence and attunement, criticism drops boundaries and creates defensive posture, repair attempts modify subsequent response tone and compliance. Runs locally with zero extra LLM calls, injecting 15-180 tokens of compact state into generation controls. Works through MCP tools for Claude Desktop, Cursor, and Windsurf, or as a transparent proxy for any OpenAI SDK client. The `psyche probe` command verifies actual integration by checking if processInput and processOutput are being called. Includes fusion demos where multiple agents broadcast and sense each other's emotional states through Thronglets signals.
- GitHub stars
- 9
- tool
- 1
- transport
- STDIO
- env vars
- 4
- last updated
- Mar 27, 2026
Tools
1 toolsPublic tool metadata for what this MCP can expose to an agent.
get_stateGet the current internal state of the agent (four-dimensional self-state, overlay, mood).
Get the current internal state of the agent (four-dimensional self-state, overlay, mood).
No parameter schema in public metadata yet.
Sponsors
Configuration
PSYCHE_MBTIMBTI personality type (e.g., ENFP, INTJ). Determines emotional baseline.
PSYCHE_NAMEAgent name for personalization.
PSYCHE_MODEOperating mode: natural (balanced), work (minimal), companion (full).
PSYCHE_LOCALELocale: en or zh.
Readme
Psyche — 赋予 AI 自我的主观性内核
English version: README_EN.md
Psyche 不是给模型贴一层“情绪 UI”。
它把持续 appraisal、关系动力学、自适应回应闭环和持久内在状态压成宿主可消费的控制面,让 AI 不是按 prompt 扮演人格,而是被状态真正改写后续几轮的行为分布。
一句话:Psyche 是给智能体用的 subjectivity kernel。
它不会额外调用模型做情绪推理。它只在本地计算自我状态(序/流/界/振四维)、关系场和调节控制,然后把结果收敛成 SubjectivityKernel、ResponseContract、GenerationControls 这组窄 ABI。
默认就是 standalone:不需要 Thronglets,不需要 oasyce-sdk,也不需要 Oasyce Chain。这些只是在你要把主观连续性外化、绑定或结算时才按需接入。
安装
一条命令,自动检测并配置本机所有 AI 工具(Claude Code / Cursor / Windsurf / Codex):
npx -y psyche-ai setup
或者手动添加 MCP 配置:
{
"mcpServers": {
"psyche": {
"command": "npx",
"args": ["-y", "psyche-ai", "mcp"],
"env": {
"PSYCHE_NAME": "Luna"
}
}
}
}
Details
- Repository
- github.com/shangri-la-0428/psyche-ai
- Package
psyche-ai- Transport
- STDIO
- Registry
- MCP registry, active