OpenAEON

OpenAEON 🦞

“EXFOLIATE! EXFOLIATE!” — A space lobster, probably

Any OS gateway for AI agents across WhatsApp, Telegram, Discord, iMessage, and more.
Send a message, get an agent response from your pocket. Plugins add Mattermost and more.

The Fractal Cognitive Engine

OpenAEON is a multi-channel gateway and an Autonomous Cognitive Engine. It is powered by the FCA Core (Fractal Cognitive Adapter), a multi-layer architecture that transforms simple AI interactions into a recursive, verifiable logic loop.

🧠 Core Philosophy

Instead of simple linear processing, OpenAEON decomposes complex problem spaces into verifiable sub-loops. It uses Peano Space-Filling Traversal to map complex tasks into high-density cognitive streams, ensuring no reasoning gaps are left behind.

🏗 9-Layer Architecture

The system is built on nine specialized layers of intelligence:

• Semantic Grounding: Mapping input to high-dimensional tokens.
• Topology Analytics: Understanding context proximity.
• Fractal Decomposition: Recursive goal splitting.
• Decision Adjudication: Policy and guardrail alignment.
• Strategy Flux: Real-time strategy auto-tuning.
• Forensic Simulation: Error replay and thought-trace reconstruction.

👉 Deep-dive into FCA Core Architecture

What is OpenAEON?

OpenAEON is a self-hosted gateway that connects your favorite chat apps — WhatsApp, Telegram, Discord, iMessage, and more — to AI coding agents. You run a single Gateway process on your own machine, and it becomes the bridge between your messaging apps and an always-available, self-evolving AI assistant.

Who is it for? Developers and power users who want a personal AI assistant they can message from anywhere — without giving up control of their data or relying on a hosted service.

How it works

The Gateway is the single source of truth for sessions, routing, and channel connections.

Key capabilities

Multi-channel gateway

WhatsApp, Telegram, Discord, and iMessage with a single Gateway process.

Plugin channels

Add Mattermost and more with extension packages.

Multi-agent routing

Isolated sessions per agent, workspace, or sender.

Media support

Send and receive images, audio, and documents.

Web Control UI

Browser dashboard for chat, config, sessions, and nodes.

Mobile nodes

Pair iOS and Android nodes with Canvas support.

Quick start

1. Install OpenAEON

   npm install -g openaeon@latest
   
2. Onboard and install the service

   openaeon onboard --install-daemon
   
3. Pair WhatsApp and start the Gateway

   openaeon channels login
   openaeon gateway --port 18789
   

Need the full install and dev setup? See Quick start.

Dashboard

Open the browser Control UI after the Gateway starts.

• Local default: http://127.0.0.1:18789/
• Remote access: Web surfaces and Tailscale

Configuration (optional)

Config lives at ~/.openaeon/openaeon.json.

• If you do nothing, OpenAEON uses the bundled Pi binary in RPC mode with per-sender sessions.
• If you want to lock it down, start with channels.whatsapp.allowFrom and (for groups) mention rules.

Example:

{
  channels: {
    whatsapp: {
      allowFrom: ["[phone]"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openaeon"] } },
}

Start here

Docs hubs

All docs and guides, organized by use case.

Configuration

Core Gateway settings, tokens, and provider config.

Remote access

SSH and tailnet access patterns.

Channels

Channel-specific setup for WhatsApp, Telegram, Discord, and more.

Nodes

iOS and Android nodes with pairing and Canvas.

Help

Common fixes and troubleshooting entry point.

Learn more

FCA Core Architecture

Fractal Cognitive Adapter: 9-layer autonomous architecture, Peano maps, and auto-tuning.

Full feature list

Complete channel, routing, and media capabilities.

Aggressive Autopilot

Zero-confirm Cognitive Task OS execution with delegation, retry, reflection, and recovery.

Multi-agent routing

Workspace isolation and per-agent sessions.

Security

Tokens, allowlists, and safety controls.

Troubleshooting

Gateway diagnostics and common errors.

About and credits

Project origins, contributors, and license.