JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 60
  • Score
    100M100P100Q95180F
  • License MIT

Hera Artificial Life — Multi-channel AI agent gateway with autonomous capabilities

Package Exports

  • @hera-al/server
  • @hera-al/server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@hera-al/server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

💎 Hera Artificial Life

The AI that doesn't just chat — it acts, evolves, and thinks ahead.

Hera is not another chatbot wrapper. It's an autonomous AI platform that combines state-of-the-art language models with unprecedented levels of autonomy, action, and self-evolution. Built on Claude Agent SDK, Hera connects to multiple communication channels while maintaining context, learning from interactions, and proactively managing tasks without constant supervision.

🌟 What Makes Hera Different

Beyond Chat: True Autonomy

  • Proactive Actions: Schedules its own tasks, monitors events, reaches out when needed
  • Self-Programming: Creates and modifies its own skills, adapts workflows
  • Memory Evolution: Nightly consolidation transforms daily interactions into long-term knowledge with RDF concept mapping
  • Multi-Modal Intelligence: Voice (TTS/STT), vision, document processing, web search

Production-Ready Architecture

  • Multi-Channel Gateway: Telegram, WhatsApp, Discord, WebChat — unified interface, consistent experience
  • Nostromo Control Center: Advanced admin panel for real-time monitoring, configuration, and orchestration
  • Distributed Execution: Remote nodes for browser automation, shell execution, cross-platform actions
  • Extensible by Design: Skills, MCP tools, plugins — choose your level of integration

Built for Developers

  • MIT Licensed Components: Core libraries available as @hera-al/* packages on npm
  • Claude Agent SDK Native: Full toolkit access, streaming, artifacts, permissions
  • TypeScript Throughout: Type-safe, maintainable, modern codebase
  • Docker Ready: One command to production

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                     COMMUNICATION LAYER                      │
│  Telegram • WhatsApp • Discord • WebChat • Voice • Browser  │
└────────────────────────┬────────────────────────────────────┘
                         │
┌────────────────────────▼────────────────────────────────────┐
│                      HERA GATEWAY                            │
│  • Session Management      • Multi-format rendering         │
│  • Permission System       • Cron Scheduler                  │
│  • Memory Pipeline         • Nostromo Admin Panel            │
└────────────────────────┬────────────────────────────────────┘
                         │
┌────────────────────────▼────────────────────────────────────┐
│                  CLAUDE AGENT SDK                            │
│  Claude Sonnet 4.5 • Tool orchestration • Streaming         │
└────────────────────────┬────────────────────────────────────┘
                         │
         ┌───────────────┴───────────────┬─────────────────┐
         │                               │                 │
┌────────▼────────┐           ┌─────────▼──────┐  ┌───────▼────────┐
│  SKILLS         │           │  MCP SERVERS   │  │  REMOTE NODES  │
│  • Google WS    │           │  • Custom      │  │  • OSXNode     │
│  • xAI Search   │           │  • Community   │  │  • Browser CDP │
│  • Apple Notes  │           │  • External    │  │  • Shell Exec  │
│  • Dreaming     │           │                │  │                │
│  • Custom...    │           │                │  │                │
└─────────────────┘           └────────────────┘  └────────────────┘

🎯 Core Components

Nostromo — The Command Center

Real-time admin panel providing:

  • Live Session Monitoring: Active conversations, context windows, tool usage
  • Skill Management: Install, update, configure, and publish skills
  • Cron Orchestration: Schedule autonomous tasks, view execution history
  • Model Registry: Switch between Claude, GPT-4, local models on the fly
  • Permission Dashboard: Approve/deny tool executions, set policies
  • System Health: Memory usage, API quotas, node connectivity

The Memory System

Three-tier memory architecture:

  1. Session Memory: Real-time context during conversations
  2. Daily Logs: Markdown files with full conversation history
  3. Long-Term Memory: Consolidated knowledge with semantic search and RDF Turtle concept maps

The dreaming skill runs nightly, identifying patterns, extracting insights, and updating the concept graph — Hera literally learns while you sleep.

Skills — Extensibility at Scale

Skills are self-contained capabilities that extend Hera's reach:

Bundled Skills:

  • google-workspace — Gmail, Drive, Docs, Sheets, Slides (OAuth2 integrated)
  • xai-search — Web and X (Twitter) search via Grok Responses API
  • apple-notes & apple-reminders — Native macOS integration
  • weather — Current conditions and forecasts
  • ssh — Remote server management
  • dreaming — Nightly memory consolidation and concept mapping
  • the-skill-guardian — Security scanner for third-party skills (90+ malicious pattern detection)
  • skill-creator — Meta-skill for creating and packaging new skills

Create Your Own:

# Skills live in .claude/skills/<name>/
# SKILL.md defines capabilities
# scripts/ subfolder contains executables
# Full access to Hera's toolkit

MCP Integration

Model Context Protocol (MCP) support allows:

  • Connecting to external data sources (databases, APIs, SaaS)
  • Using community MCP servers (Notion, Linear, GitHub, etc.)
  • Building custom MCP servers for proprietary systems

Remote Nodes

WebSocket-based execution nodes for distributed actions:

  • StandardNode: Shell execution on any machine (npm package: @hera-al/standardnode)
  • OSXNode: Native macOS app with SwiftUI interface, markdown rendering, notifications
  • Browser Nodes: Chrome DevTools Protocol (CDP) automation for web scraping, testing, interaction

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • Anthropic API key
  • (Optional) Telegram bot token, OpenAI API key for voice

Installation

# Clone or install
npm install -g @hera-al/server

Configuration

Create .env:

# Required
ANTHROPIC_API_KEY=sk-ant-...
DATA_FOLDER=/path/to/data

# Channels (optional)
TELEGRAM_BOT_TOKEN=123456789:ABC...
WHATSAPP_ENABLED=true

# Voice (optional)
OPENAI_API_KEY=sk-...
TTS_PROVIDER=openai
TTS_VOICE=echo

# Nostromo (optional)
NOSTROMO_PORT=3030
NOSTROMO_ENABLED=true

See .env.example for all options.

Launch

# Start the gateway
npm start

# Or with Nostromo
npm run server:with-nostromo

# CLI tools
hera             # Interactive management CLI
heraserver       # Start server programmatically
hera-install      # Installation wizard

Access Nostromo at http://localhost:3030 (default).

📚 Use Cases

Personal AI Assistant

  • Manages emails, calendar, reminders across platforms
  • Proactively surfaces relevant information
  • Learns preferences and adapts over time

Team Collaboration Hub

  • Multi-channel presence (Slack, Discord, Telegram simultaneously)
  • Skill-based workflows (CI/CD triggers, code reviews, deployments)
  • Shared memory and knowledge base

Autonomous Automation

  • Scheduled tasks via cron (data scraping, report generation, monitoring)
  • Self-healing workflows (detect failures, retry with exponential backoff)
  • Cross-platform orchestration (Mac → Linux → Cloud)

Research & Development

  • Memory consolidation identifies patterns in conversations
  • Concept mapping reveals hidden connections
  • Export knowledge graphs for analysis

🧩 Ecosystem

Published Packages

Package Description npm
@hera-al/server Core gateway (coming soon) —
@hera-al/browser-server WebChat UI component 📦
@hera-al/standardnode Remote execution node client (coming soon)

GitHub Organization

🔐 Security

The Skill Guardian

Before installing any third-party skill, run:

hera skill-scan <path-to-skill>

Detects 90+ malicious patterns including:

  • Code execution & shell injection
  • Data exfiltration & credential theft
  • Persistence mechanisms
  • Prompt injection attacks

Permission System

Fine-grained control over:

  • Tool execution (approve/deny on demand or via policy)
  • File system access (read/write boundaries)
  • Network requests (allowlist/blocklist domains)
  • Skill capabilities (sandbox mode)

🌱 Philosophy: Hera vs. OpenClaw

OpenClaw is the open-source framework — maximum flexibility, community-driven, all options on the table.

Hera is the opinionated product — curated experience, cohesive design, decisions made for you. Think Rails vs. Express, or macOS vs. Linux.

Both are valid. Hera makes choices so you don't have to. The building blocks (npm packages) are MIT licensed. The product (gateway + curated skills + Nostromo) is the Hera experience.

🛠️ Development

Project Structure

grabmeabeer/
├── src/                 # Gateway source code
│   ├── channels/        # Telegram, WhatsApp, Discord, WebChat
│   ├── agent/           # Claude SDK integration
│   ├── memory/          # Semantic search, RDF concept map
│   ├── cron/            # Scheduler & job management
│   └── tools/           # Built-in tools (node_exec, TTS, etc.)
├── browser-server/      # WebChat UI (published to npm)
├── standardnode/        # Remote node client (published to npm)
├── .claude/skills/      # Skill directory
├── bundled/             # Pre-installed skills
├── installationPkg/     # Installation wizard assets
└── nostromo/            # Admin panel source

Contributing

  1. Fork the repo
  2. Create a feature branch
  3. Write tests (when applicable)
  4. Submit a pull request

Skill contributions welcome! See .claude/skills/skill-creator/SKILL.md for the template.

📖 Documentation

  • Installation Guide: docs/installation.md (coming soon)
  • Skill Development: .claude/skills/skill-creator/SKILL.md
  • API Reference: docs/api.md (coming soon)
  • Nostromo Manual: docs/nostromo.md (coming soon)

🙏 Credits

Built With

Inspiration

Standing on the shoulders of giants: OpenClaw, AutoGPT, LangChain, and the entire open-source AI community.

📄 License

MIT License — see LICENSE for details.

Core components (@hera-al/* packages) are free and open source. Build, fork, modify, deploy commercially — it's yours.

The Hera product (curated gateway + skills + Nostromo) represents our vision of what an AI agent should be. Use the components freely; experience Hera as intended.

💎 Hera Artificial Life
Opinionated AI. Curated experience. Unprecedented autonomy.