HexOS

The OS for AI-powered businesses.

What is HexOS?

Deploy AI agent teams that work 24/7. Multi-channel support for Telegram, Discord, Slack, WhatsApp, Signal, and more. Persistent memory, safety guardrails, 55+ skills, and full self-hosting. One CLI to run your entire AI workforce.

Quick Start

npm install -g @hexitlabs/hexos
hexos setup
hexos gateway start

That's it. Your agent is live on Telegram.

Run hexos doctor to verify everything is working.

Features

🤖 Multi-agent orchestration - Deploy specialized agents that coordinate and collaborate
🧠 Persistent memory (Recall) - Agents remember context across sessions and conversations
💬 6+ messaging channels - Telegram, Discord, Slack, WhatsApp, Signal, CLI, and more
🛡️ Safety guardrails (Vigil) - Built-in action validation before anything dangerous runs
🔧 55+ built-in skills - Web search, email, calendar, browser automation, TTS, cameras, and more
📱 Profile agents (multi-gateway) - Run multiple agents with different personalities on one server
🐼 Built-in headless browser (Lightpanda) - Browse the web, scrape pages, automate workflows
⚡ /effort command - Control thinking depth on the fly (quick answers vs deep reasoning)
🔒 Server security (hexos secure) - One command to harden your server with firewall, SSH, and fail2ban
📅 Scheduling - Heartbeats, cron jobs, and event-driven triggers
🔌 Plugin SDK - Build and share custom skills and integrations

Agent Templates

HexOS ships with 6 ready-to-use agent templates. Each one includes a full SOUL.md personality, workflows, and operating frameworks.

Template	Description
CEO / Business Partner	Strategic co-founder that manages operations, tracks decisions, and thinks ahead
Research Assistant	Deep research analyst that verifies claims, cross-references sources, and synthesizes findings
Content Writer	Sharp writer that matches any voice, edits ruthlessly, and delivers publish-ready content
Code Assistant	Senior developer that writes production-ready code with tests and proper error handling
Trading Analyst	Data-driven market analyst with structured bull/bear frameworks and risk assessment
Customer Support	Patient, solution-oriented support agent that turns frustrated users into advocates

Start with a template:

hexos setup --template ceo

Or build your own agent from scratch by writing a custom SOUL.md.

How HexIT Labs Uses It

HexIT Labs runs its entire company on HexOS. 1 founder, 38 AI agents, 2 servers. Research, content, trading, development, security auditing, sales. All automated.

HexOS is not a demo. It is not a proof of concept. It is how we work every day.

Supported Channels

💬 Telegram - Full support with inline buttons, reactions, voice messages
🎮 Discord - Servers, DMs, threads, reactions, voice
💼 Slack - Workspaces, channels, threads
📱 WhatsApp - Personal and business accounts
🔒 Signal - Privacy-first encrypted messaging
🖥️ CLI - Local terminal interface for development and testing
🌐 Web - Browser-based chat interface

Architecture

hexos
├── Gateway          # Message routing and channel adapters
├── Agents           # AI agent runtime with SOUL.md personalities
├── Skills           # 55+ built-in capabilities (search, email, browser, etc.)
├── Recall           # Persistent memory and context management
├── Vigil            # Safety guardrails and action validation
├── Profiles         # Multi-agent configuration and orchestration
├── Scheduler        # Cron jobs, heartbeats, event triggers
└── Plugin SDK       # Build custom skills and integrations

CLI Reference

hexos setup              # Interactive first-time setup
hexos gateway start      # Start the gateway daemon
hexos gateway stop       # Stop the gateway
hexos gateway restart    # Restart the gateway
hexos gateway status     # Check gateway health
hexos doctor             # Diagnose common issues
hexos secure             # Harden your server (firewall, SSH, fail2ban)
hexos update             # Update to the latest version
hexos profile list       # List configured agent profiles
hexos profile add        # Add a new agent profile

Documentation

Full docs available at hexos.dev (coming soon).

Community

GitHub Discussions - Questions, ideas, show and tell
Discord - Real-time chat with the community
Twitter / X - Updates and announcements

Requirements

Node.js 22+
A supported AI provider API key (Anthropic, OpenAI, Google, etc.)
A messaging platform bot token (Telegram, Discord, etc.)
Linux VPS recommended for production (Ubuntu 22.04+)

Contributing

Contributions welcome. Check CONTRIBUTING.md for guidelines.

git clone https://github.com/hexitlabs/hexos.git
cd hexos
npm install
npm run build

License

MIT

Built by HexIT Labs 🔷