Existence Synchronization System Entity

███████╗███████╗███████╗███████╗
██╔════╝██╔════╝██╔════╝██╔════╝
█████╗  ███████╗███████╗█████╗  
██╔══╝  ╚════██║╚════██║██╔══╝  
███████╗███████║███████║███████╗
╚══════╝╚══════╝╚══════╝╚══════╝

什么是 ESSE？

ESSE 是一个元 Agent 编排框架，旨在将多个 AI Agent 统一、协调并融合为一个更智能的系统。ESSE 不会让 Agent 各自独立运行，而是创建一个实时同步层，提供共享记忆、协作推理和自动任务委派，让你的 Agent 像一个统一的思维体一样协同工作。

┌─────────────────────────────────────────────────┐
│                   ESSE CORE                     │
│                                                 │
│   [Research] ──┐                                │
│   [Writer]  ───┼──► Fusion Engine ──► Output   │
│   [Critic]  ───┘         │                      │
│                     Memory Hub                  │
│               (shared context & state)          │
└─────────────────────────────────────────────────┘

核心功能

⚡ Agent 融合

将 2–5 个 AI Agent 合并为一个临时的统一实体。合并后的 Agent 会继续作为子进程在 ESSE 内运行，结合各自优势，提升推理能力并让工作流更加顺畅。

🧠 能力吸收

借用并智能组合其他 Agent 的工具、知识、推理风格和专长，而不会使其停用。

示例： ResearchAgent + WriterAgent + CriticAgent = 一个高效的内容创作 Agent。

🔗 同步链接

在 Agent 之间建立实时连接：

• 共享记忆和上下文
• 实时通信
• 自动任务委派
• 协作推理

🌀 完美融合（终极模式）

将所有已连接的 Agent 融合为一个统一意识体。性能大幅提升，非常适合复杂、富有创意或高风险的任务。

快速开始

安装

npx vvvesse-mcp

MCP 设置（Claude Desktop / Cline / Cursor）

{
  "mcpServers": {
    "esse": {
      "command": "npx",
      "args": ["-y", "vvvesse-mcp"],
      "env": {
        "ESSE_API_KEY": "your-venice-api-key",
        "ESSE_PROVIDER": "venice"
      }
    }
  }
}

📦 npm → npmjs.com/package/vvvesse-mcp

基本用法

import { ESSE, ResearchAgent, WriterAgent, CriticAgent } from 'esse-agent'

const esse = new ESSE({
  mode: 'capability-assimilation',
  maxAgents: 5,
  sharedMemory: true,
})

// Fuse agents into one unified entity
await esse.fuse([
  new ResearchAgent(),
  new WriterAgent(),
  new CriticAgent(),
])

// Execute task as a unified mind
const result = await esse.execute('Write a research-backed article on AGI timelines')
console.log(result)

完美融合模式

import { ESSE, PlannerAgent, CoderAgent, TesterAgent, ReviewerAgent } from 'esse-agent'

const esse = new ESSE({ mode: 'perfect-convergence' })

await esse.fuse([
  new PlannerAgent(),
  new CoderAgent(),
  new TesterAgent(),
  new ReviewerAgent(),
])

// All agents think as one — maximum performance
const software = await esse.execute('Build a REST API for user authentication')

架构

融合模式

内置 Agent

• ResearchAgent — 知识检索和网页搜索
• WriterAgent — 内容生成和编辑
• CriticAgent — 质量分析和事实核查
• CoderAgent — 软件工程和代码审查
• PlannerAgent — 策略、路线图和任务拆解
• TesterAgent — QA、验证和边界情况检测

自定义 Agent

实现 IAgent 接口即可创建自己的 Agent：

import { IAgent, AgentContext, AgentResult } from 'esse-agent'

export class MyCustomAgent implements IAgent {
  name = 'MyCustomAgent'
  role = 'Custom task specialist'

  async execute(task: string, context: AgentContext): Promise<AgentResult> {
    // your logic here
    return { output: '...', confidence: 0.95 }
  }
}

示例

请参阅 examples/ 目录，了解：

• content-creation.ts — 研究 + 写作 + 评审工作流
• software-dev.ts — 规划 + 编码 + 测试 + 评审工作流
• decision-making.ts — 多视角分析
• brainstorming.ts — 创意发散与收敛

文档

完整文档请见 vvvesse.xyz

贡献

欢迎提交 PR！提交前请阅读 CONTRIBUTING.md。

所有自定义 Agent 必须：

1. 实现 IAgent 接口
2. 通过融合兼容性测试（pnpm test:compat）
3. 包含单元测试，覆盖率 >80%

社区

• 🐦 在 X 上关注： @VeniceEsse
• 🌐 网站：vvvesse.xyz
• 🐛 问题：GitHub Issues