@openenthrium/oe-runtime

Open Enthrium AI Agent Runtime · @openenthrium/oe-runtime

OE Runtime · Standalone AI Agent Executor · Apache-2.0 · Windows · Linux · macOS

Run AI agents against any enterprise data source — no cloud, no platform, just a single binary.

What is OE Runtime?

Open Enthrium AI Agent Runtime (OE Runtime) is a standalone, cross-platform binary that reads a declarative YAML agent file, connects to your enterprise data sources, and runs an AI-powered workflow — locally or as an HTTP API server.

• No LangChain. No Python. No code. Agents are plain YAML files.
• No install. Single binary for Windows, Linux, and macOS. No Node.js, no Docker on the target machine.
• 45+ connector categories. PostgreSQL, MySQL, MongoDB, S3, Slack, GitHub, SSH, REST API, Kafka, and more — all built in.
• Agent chains. Chain agents together in YAML — auto chains fire in sequence; manual chains pause for human approval in CLI (y/n prompt), HTTP (/approve-chain), or any MCP-enabled AI chat (approve_chain tool).
• HTTP server mode. --serve turns the runtime into a persistent API server any app can call.
• SDK. @openenthrium/oe-runtime-sdk lets you embed agent execution directly inside your Node.js app — same engine, no subprocess, no HTTP call. npm install @openenthrium/oe-runtime-sdk
• Messaging platform integration. Receive messages from Telegram, Slack, WhatsApp, Teams and run agents in response — same YAML agents, same connectors, universal command language (/run, /agents, /approve, /status).
• Project system. oe-project.json registers multiple agents by name, sets a default agent, and links projects together — one config, many agents.
• Self-hosted. Runs entirely on your own machine. No call-home. Own your data.

Sample Library

Download oe-runtime-samples.zip for 24 ready-to-run starter kits — each with a complete agent.yaml + oe-config.json:

Getting started — hello-world · chains · my-ai-project

By connector — sql-databases · nosql-cache · file-storage · cloud-drives · email · team-messaging · telegram · productivity-crm · rest-api · graphql · ssh · message-queues · iot-messaging · web-search · ocr-vision · image-generation · speech-audio · video-generation · music-generation · blockchain-web3 · directory-identity

Quick Start

No binary download needed — npx handles everything automatically.

1. Edit oe-config.json with your LLM key and connector credentials

{
  "llm": {
    "provider": "openai",
    "apiKey": "sk-...",
    "model": "gpt-4o"
  },
  "connectors": [
    {
      "connection_name": "My Database",
      "connection_type": "postgresql",
      "host": "localhost",
      "port": 5432,
      "database": "mydb",
      "user": "postgres",
      "password": "YOUR_DB_PASSWORD"
    },
    {
      "connection_name": "My Telegram Bot",
      "connection_type": "telegram",
      "baseUrl": "https://api.telegram.org/botYOUR_BOT_TOKEN"
    }
  ],
  "server": {
    "enabled": false,
    "port": 3333,
    "apiKey": "your-secret"
  }
}

2. Edit agent.yaml if needed — adjust the instructions or steps for your use case

Agents are plain YAML files. No Python. No framework to learn.

name: DB Summary Agent
description: Queries a database and sends a summary to Telegram
instructions: |
  You are a data analyst. Query the database for key metrics,
  summarise the findings clearly, and send the report to Telegram.
  Complete all steps fully before writing your report.
steps:
  - name: Query metrics
    content: |
      Run exactly this query against My Database, no other queries:
      SELECT table_name FROM information_schema.tables
      WHERE table_schema = 'public';
      Summarise the results.
  - name: Get chat ID
    content: |
      Call My Telegram Bot:
      GET /getUpdates with params: { "limit": "1" }
      Extract the chat_id from the most recent message.
  - name: Send report
    content: |
      Send the summary via My Telegram Bot:
      POST /sendMessage with body:
      {
        "chat_id": "<chat_id from previous step>",
        "text": "<your summary>",
        "parse_mode": "Markdown"
      }
connectors:
  - connection_name: My Database
    connection_type: postgresql
  - connection_name: My Telegram Bot
    connection_type: telegram

YAML Agent Reference

Field	Required	Description
name	No	Display name shown in terminal
description	No	Short description
instructions	Yes	System prompt — what the agent does and how
params	No	Named parameters; substituted via {{name}} in prompt and steps
connectors	No	Connector references matched to credentials in oe-config.json
steps	No	Named workflow steps injected sequentially into the system prompt
maxRounds	No	Max LLM tool-call iterations (default: 25)
chains	No	Agents to run after this one completes — see Agent Chains below

chains syntax:

chains:
  - next_agent: ./followup.yaml     # relative path from this agent file
    trigger_type: auto              # fires immediately, output passed as context

  - next_agent: ./notify.yaml
    trigger_type: manual            # CLI: y/n prompt · HTTP: /approve-chain · MCP: approve_chain tool

3. Run it

npx -y @openenthrium/oe-runtime agent.yaml --config oe-config.json

Note: -y skips npx's install confirmation prompt — without it, npx blocks waiting for keyboard input and the agent never runs.

Run Modes

Mode	Command	Best for
CLI	npx -y @openenthrium/oe-runtime agent.yaml --config oe-config.json	One-shot agent runs, scripts, CI/CD
HTTP Server	npx -y @openenthrium/oe-runtime --serve --config oe-config.json	Persistent API server any app can call

Tip: Set "server": { "enabled": true } in oe-config.json to auto-start as HTTP server without the --serve flag.

HTTP Server Mode

Turn the runtime into a persistent HTTP API — call agents from mobile apps, web services, or any HTTP client.

Step 1 — Enable server mode in oe-config.json:

{
  "llm": { "provider": "openai", "apiKey": "sk-...", "model": "gpt-4o" },
  "server": {
    "enabled": true,
    "port": 3333,
    "apiKey": "your-secret-api-key"
  },
  "connectors": [ ... ]
}

Set "enabled": true to activate server mode on startup.

Step 2 — Start in serve mode:

npx -y @openenthrium/oe-runtime --serve --config oe-config.json
# 🚀  OE Runtime Server  v1.6.1
#      Run AI agents via HTTP
# Listening  http://localhost:3333

Endpoints

All endpoints require the x-api-key header when server.apiKey is set in your config.

Method	Path	Description
GET	/health	Liveness check — returns { "status": "ok", "version": "..." }
GET	/status	Health + project info + connector list + uptime
POST	/command	Universal command endpoint — { text: "/run agent-name" }
POST	/run	Run an agent from an inline YAML string
POST	/run-file	Run an agent from a YAML file path on disk
POST	/approve-chain	Approve or reject a pending manual chain
POST	/webhook/telegram	Telegram webhook receiver (enabled via server.webhook)
POST	/webhook/slack	Slack webhook receiver (enabled via server.webhook)

POST /run — body (inline YAML):

{
  "yaml": "name: My Agent\nsteps:\n  - name: Run\n    content: Execute the task",
  "params": {},
  "input": "run"
}

POST /run-file — body (file path on server disk):

{
  "file": "/path/to/agent.yaml",
  "params": { "topic": "AI trends" },
  "input": "run"
}

Response (both /run and /run-file):

{
  "success": true,
  "output": "Agent output...",
  "chains": [
    { "agent": "Follow-up Agent", "output": "Chain complete ✅", "chains": [], "pending_chains": [] }
  ],
  "pending_chains": [
    { "chain_id": "abc123xyz", "next_agent": "./notify.yaml", "output_preview": "Agent output..." }
  ],
  "duration_ms": 1234
}

POST /approve-chain — approve or reject a manual chain:

{ "chain_id": "abc123xyz", "approved": true }

Response:

{ "success": true, "approved": true, "output": "...", "chains": [], "pending_chains": [], "duration_ms": 890 }

Example curl:

# Health check
curl http://localhost:3333/health -H "x-api-key: your-secret"

# Run agent from inline YAML
curl -X POST http://localhost:3333/run \
  -H "x-api-key: your-secret" \
  -H "Content-Type: application/json" \
  -d '{"yaml": "name: Hi\nsteps:\n  - name: Greet\n    content: Say hi!", "params": {}, "input": "run"}'

# Run agent from file on disk (with chain support)
curl -X POST http://localhost:3333/run-file \
  -H "x-api-key: your-secret" \
  -H "Content-Type: application/json" \
  -d '{"file": "/path/to/agent.yaml", "params": {}, "input": "run"}'

# Approve a pending manual chain
curl -X POST http://localhost:3333/approve-chain \
  -H "x-api-key: your-secret" \
  -H "Content-Type: application/json" \
  -d '{"chain_id":"abc123xyz","approved":true}'

Project System

oe-project.json sits alongside oe-config.json and registers multiple agents by name — so any interface (Telegram, Slack, HTTP, MCP) can invoke them by name rather than file path.

{
  "name": "Sales Pipeline",
  "version": "1.0.0",
  "description": "Outbound sales automation",
  "author": "Your Name",
  "tags": ["sales", "outbound"],
  "agents": [
    { "name": "prospecting",  "file": "./prospecting.yaml",  "description": "Find and qualify leads" },
    { "name": "outreach",     "file": "./outreach.yaml",     "description": "Send personalised emails" },
    { "name": "chat",         "file": "./chat-bot.yaml",     "description": "Conversational assistant", "default": true }
  ],
  "links": [
    { "name": "support", "project": "../support-project/oe-project.json" }
  ]
}

Field	Description
name, version, author, tags	Project metadata
agents[].name	Short name used to invoke the agent (/run prospecting)
agents[].file	Path to the YAML agent file (relative to oe-project.json)
agents[].default	true — runs this agent when user sends a plain message (no command)
links	Cross-project references — run agents from linked projects

Messaging Platforms (Telegram, Slack, WhatsApp, Teams)

OE Runtime's HTTP server can receive messages from any webhook-based messaging platform and run agents in response — no separate bot framework needed.

oe-config.json — enable webhook receiver:

{
  "llm": { "provider": "openai", "apiKey": "sk-...", "model": "gpt-4o" },
  "server": {
    "enabled": true,
    "port": 3333,
    "publicUrl": "https://your-public-domain.com",
    "webhook": {
      "enabled": true,
      "auto_reply": true
    }
  },
  "connectors": [
    {
      "connection_name": "My Telegram Bot",
      "connection_type": "telegram",
      "baseUrl": "https://api.telegram.org/botYOUR_BOT_TOKEN"
    }
  ]
}

OE Runtime automatically calls Telegram's setWebhook on startup. For Slack, paste the URL shown in the terminal into your Slack app's Event Subscriptions.

Universal command language — same commands work from Telegram, Slack, HTTP, or MCP:

Command	Action
/run <name>	Run agent by name (from oe-project.json)
/run <path>	Run agent by file path
/agents	List all registered agents
/approve	Approve a pending manual chain
/cancel	Cancel a pending chain
/status	Health check — LLM, connectors, uptime
/projects	List linked projects
/help	Show all commands
Any message	Runs the "default": true agent

POST /command — same commands from HTTP clients:

curl -X POST http://localhost:3333/command \
  -H "x-api-key: your-secret" \
  -H "Content-Type: application/json" \
  -d '{"text": "/run prospecting"}'

Supported platforms:

Platform	Webhook endpoint	Auto-registers
Telegram	POST /webhook/telegram	✅ Yes — calls setWebhook on startup
Slack	POST /webhook/slack	No — paste URL in Slack Event Subscriptions
WhatsApp (Meta)	POST /webhook/whatsapp	No — paste URL in Meta Developer dashboard
GitHub	POST /webhook/github	No — paste URL in repo webhook settings

Embed in Your App

Need to call agents from inside a Node.js application — without spawning a subprocess or making HTTP calls? Use the OE Runtime SDK:

npm install @openenthrium/oe-runtime-sdk pg   # install only the connectors you need

const { runAgent } = require("@openenthrium/oe-runtime-sdk");

const result = await runAgent("./agent.yaml", "./oe-config.json", { topic: "Q3 sales" });
console.log(result.output);

Same engine. Same agent.yaml. Same oe-config.json. No subprocess overhead.

→ @openenthrium/oe-runtime-sdk on npm

Binary vs Node.js Mode

Both npx @openenthrium/oe-runtime and the standalone binary exclude Oracle, MSSQL, SQLite, and Snowflake — these use native C++ addons that cannot be bundled into a single executable. npx downloads the same binary under the hood, so it has the same limitation.

If you need any of these four, run with Node.js directly instead:

git clone https://github.com/enthrium/open-enthrium-ai-agent-runtime.git
cd open-enthrium-ai-agent-runtime/server
yarn install
node cli/index.js agent.yaml --config oe-config.json
# or serve mode
node cli/index.js --serve --config oe-config.json

All other connectors (PostgreSQL, MySQL, MongoDB, Redis, S3, Slack, GitHub, REST API, SSH, etc.) work directly with npx — no Node.js clone required.

Connector Catalog

Connectors across multiple categories — built in, no custom code required.

Category	Examples
SQL Databases	PostgreSQL, MySQL, MSSQL, Oracle, SQLite, Snowflake, BigQuery, Redshift
NoSQL / Cache	MongoDB, Redis, Elasticsearch, DynamoDB, Cassandra, Couchbase
Object Storage	AWS S3, GCS, Azure Blob, MinIO, Cloudflare R2, Backblaze B2
Cloud Drives	Google Drive, OneDrive, SharePoint, Dropbox, Box
Filesystem	Local directories — list, read, write, search files
Email	Gmail, Outlook, Zoho Mail, SMTP, IMAP, SendGrid
Team Messaging	Slack, Microsoft Teams, Discord, Telegram
CRM / Productivity	HubSpot, Salesforce, Notion, Airtable, Confluence
Issue Tracking	GitHub, Jira, GitLab, Linear
REST API	Any HTTP/REST endpoint — bearer, API key, basic auth
GraphQL	Any GraphQL endpoint
SSH / SFTP	Remote command execution and file transfer
Message Queues	Kafka, AWS SQS, Azure Service Bus, Google Pub/Sub, RabbitMQ
IoT / MQTT	MQTT brokers, AWS IoT
Search	Perplexity, Google Custom Search, Bing
LDAP / Directory	Active Directory, OpenLDAP, Azure AD
OCR / Vision	Azure Vision, Google Vision, AWS Textract
Image Generation	OpenAI gpt-image-1, FLUX, Stable Diffusion, Ideogram
Speech & Audio	ElevenLabs, OpenAI TTS, Azure Speech, Google TTS
Video Generation	Runway, Kling, Pika
Music Generation	kie.ai, Udio
Web3 / Blockchain	Ethereum, Polygon, Solana via web3.js / ethers.js
Helpdesk	Zendesk, Freshdesk, Intercom
ERP	SAP, Oracle ERP, Microsoft Dynamics
+ more	Healthcare (FHIR), Marketing, Analytics, Finance, HR, E-commerce, ...

Supported LLM Providers

openai · anthropic · azure · groq · gemini · ollama · mistral · deepseek · together · fireworks · bedrock · and more

Contributing

Contributions are welcome. Before opening a PR:

• Open an issue to discuss the change — especially for new features
• Fork the repository and branch from main
• Test your changes locally
• Open a PR with a clear description of what and why

Where contributions are most valuable:

• New connector adapters (server/src/utils/tools/adapters/)
• Agent YAML examples for the community marketplace
• Bug fixes with clear reproduction steps

Part of Open Enthrium

OE Agent Runtime is the open-source standalone execution layer of the Open Enthrium platform.

🖥️ Platform	open-enthrium-ai-platform — full web app with workspaces, RAG, Agent Builder, DLP
🔌 MCP Server	open-enthrium-ai-mcp-server — connect Claude Code, Cursor, Windsurf to enterprise data
🌐 Website	openenthrium.com

License

Apache-2.0 — free to use, modify, and deploy for any purpose, including commercial use. No usage limits. No telemetry. No call-home.