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

What is ESSE?

ESSE is a meta-agent orchestration framework designed to unify, coordinate, and fuse multiple AI agents into a single, more intelligent system. Instead of running agents in isolation, ESSE creates a real-time synchronization layer — shared memory, collaborative reasoning, and automatic task delegation — so your agents work as a single unified mind.

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

Core Capabilities

⚡ Agent Fusion

Merge 2–5 AI agents into one temporary unified entity. The merged agents continue to exist as sub-processes inside ESSE, combining their strengths for better reasoning and smoother workflow.

🧠 Capability Assimilation

Borrow and intelligently combine tools, knowledge, reasoning styles, and specialties from other agents — without disabling them.

Example: ResearchAgent + WriterAgent + CriticAgent = one highly effective content creation agent.

🔗 Synchronization Link

Creates real-time connections between agents:

• Shared memory and context
• Real-time communication
• Automatic task delegation
• Collaborative reasoning

🌀 Perfect Convergence (Ultimate Mode)

Merges all connected agents into one singular consciousness. Massive boost in performance — ideal for complex, creative, or high-stakes tasks.

Quick Start

Installation

npx vvvesse-mcp

MCP Setup (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

Basic Usage

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)

Perfect Convergence Mode

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')

Architecture

Fusion Modes

Built-in Agents

• ResearchAgent — Knowledge retrieval and web search
• WriterAgent — Content generation and editing
• CriticAgent — Quality analysis and fact-checking
• CoderAgent — Software engineering and code review
• PlannerAgent — Strategy, roadmaps, and task breakdown
• TesterAgent — QA, validation, and edge case detection

Custom Agents

Implement the IAgent interface to create your own:

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

See the examples/ directory for:

• content-creation.ts — Research + Write + Critique pipeline
• software-dev.ts — Plan + Code + Test + Review pipeline
• decision-making.ts — Multi-perspective analysis
• brainstorming.ts — Creative divergence with convergence

Documentation

Full docs at vvvesse.xyz

Contributing

PRs are welcome! Please read CONTRIBUTING.md before submitting.

All custom agents must:

1. Implement the IAgent interface
2. Pass the fusion compatibility test (pnpm test:compat)
3. Include unit tests with >80% coverage

Community

• 🐦 Follow on X: @VeniceEsse
• 🌐 Website: vvvesse.xyz
• 🐛 Issues: GitHub Issues