Skip to content

vuics/h9y

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1,466 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ™ HyperAgency (h9y.ai)

HyperAgency Text Logo

Website Docs Paper Contribute License Pilot

HyperAgency is an Agentic AI Operating System that replaces brittle, fragile automations with long-lived, self-improving systems. HyperAgency allows organizations to deploy autonomous agents that remember, adapt, and act on your behalf, under human governance and auditability.

It is open-source, model-agnostic, and cloud/self-hosted, providing the infrastructure to build fully autonomous AI-human organizations.

🧠 Think of HyperAgency as your operating system for autonomous workflows β€” distributed, flexible, and composable.

πŸ“˜ Explore the HyperAgency Documentation for full capabilities, architecture, agent archetypes, integration examples, and step-by-step guides.

πŸ“„ Read the HyperAgency Research Paper for the system design, implementation and use cases.

🎬 Watch about HyperAgency on YouTube

Watch About Video


πŸš€ What is HyperAgency?

HyperAgency is more than an AI platform β€” it's a new operational layer:

  • Persistent Agency β€” agents maintain memory and context across time, adapting to real-world changes.
  • Coordinated Intelligence β€” multiple agents work together to solve complex problems.
  • Human Governance β€” clear approval points, credential management, and auditable behavior.
  • Omni-Channel Connectivity β€” integrate across messengers, web apps, email, and APIs.
  • Decentralized Architecture β€” connect multiple HyperAgency instances for distributed collaboration.
  • Web3 Marketplace β€” publish, buy, and monetize agentic workflows and HyperAgents.
  • MetaAgent β€” self-developing AI that creates, evolves, and orchestrates agents autonomously.

HyperAgency turns AI from fragile scripts and prompts into living, compound intelligence systems.

What Is


🌟 Key Features

  • βœ… Create & Deploy Agents β€” instant archetypes or custom blueprints.
  • πŸ’¬ Multi-Agent Communication β€” human and AI interaction in one interface.
  • πŸ—ΊοΈ Map View β€” visualize workflows and agent coordination.
  • 🧩 Composable Systems β€” agents can orchestrate other agents, integrate APIs, run scripts, generate content, or process data.
  • πŸ”€ Persistent Memory β€” knowledge, workflow state, and context are shared and versioned.
  • πŸ” Governance & Security β€” Vault-secured credentials, audit logs, approvals.
  • 🌍 Distributed Nodes β€” federated network for scalable collaboration.
  • ⚑ Rapid Deployment β€” cloud or local containerized setup, production-ready.

Experience Components


🧩 Agent Archetypes

HyperAgency comes with 20+ production-ready agents you can deploy instantly:

Archetype Role / Function
Chat Natural language communication
RAG Research & document retrieval
ImageGen Image generation from prompts
BrowserUse Web navigation & task automation
Hermes Autonomous general-purpose agent
OpenClaw Personal AI assistant
Codex Software engineering agent
ClaudeCode (connector) Coding assistant connector
STT Speech-to-text transcription
TTS Text-to-speech synthesis
Avatar Talking faces with lip-sync
Maptrix Nested workflow execution
Code Python, JavaScript, Bash computation
Command Linux command execution
Quantum Quantum computing tasks
Storage Key-value and file storage
Transform Text transformation & templating
System HyperAgency infrastructure management
MCP Tool execution via Model Context Protocol
A2A Agent-to-agent delegation
Curl API / HTTP requests
Langflow AI strategy & multi-agent orchestration
Node-RED External API & IoT workflow integration
N8n Flexible automation workflows
Notebook Parameterized Jupyter notebooks

All agents are composable, versionable, portable (JSON), auditable, and reproducible.

Agent Archetypes


βš™οΈ Model Providers

Each agent can run any compatible LLM or model based on role, cost, latency, or compliance:

  • Ollama (local open-source LLMs)
  • Speaches (local open-source TTS/STT models)
  • OpenAI
  • Anthropic
  • Google (Vertex AI / GenAI)
  • Azure
  • Mistral
  • Groq
  • Cohere
  • Fireworks
  • Together
  • Hugging Face
  • NVIDIA
  • Amazon / Bedrock
  • Databricks
  • IBM
  • AI21
  • Upstage
  • xAI
  • Perplexity

Agents are bound to intent, not to a single model β€” no vendor lock-in.

Model Agnostic


πŸ’¬ Omni-Channel Integration

Deploy agents across any communication channel in seconds:

  • Messengers: XMPP, Telegram, Slack, Discord, MS Teams, WhatsApp, VK, Mattermost, Matrix, IRC, Zulip, Rocket Chat, SSH Chat, NextCloud Talk, Muble, Keybase
  • Email: IMAP/SMTP
  • Phone: FreeSwitch
  • Scheduler: Cron
  • Webhooks Server
  • A2A Server
  • MCP Server
  • Web App: Lowdefy
  • XMPP Server

Bridges let agents communicate, automate, and act across your digital ecosystem.

Omni Channel


🧭 Observability

Full visibility into agent actions, memory, and evolution:

  • Logs & metrics in real-time
  • Debug and trace workflows across agents
  • Performance monitoring and system health
  • Privacy-first design β€” isolated data per organization

Logs & Metrics


🌐 Distributed & Decentralized

HyperAgency supports secure peer-to-peer networks:

  • Scale horizontally with multiple nodes
  • Share agents across trusted nodes and teams
  • Retain full control over privacy and data ownership

Distributed System


πŸͺ Web3 Marketplace

  • Publish, share, and monetize HyperAgent packages
  • Join a global ecosystem of builders and innovators
  • Enable agentic deals with verifiable capabilities

Web3 Marketplace


πŸ“Š Installation Feature Comparison

This section helps you understand what capabilities are available depending on how you install HyperAgency.

We support four deployment modes:

  • A. 🧩 Standalone (individual) β€” single all-in-one Docker container for quick start and local testing
  • B. 🐳 Docker Cluster (team) β€” multi-service Docker Compose setup for personal or team deployments
  • C/D. ☸️ Kubernetes Cluster (enterprise) β€” scalable enterprise-grade infrastructure deployment (on-prem or private-cloud)
  • E. ☁️ HyperAgency Cloud (any) β€” fully managed hosted platform at https://h9y.ai

πŸš€ Feature Matrix (Capabilities by Installation Type)

Feature Standalone Docker Cluster Kubernetes Cluster HyperAgency Cloud
Web-Landing ❌ ❌ βœ… βœ…
Dashboard βœ… βœ… βœ… βœ…
Hive βœ… βœ… βœ… βœ…
Chat βœ… βœ… βœ… βœ…
Map βœ… βœ… βœ… βœ…
Data βœ… βœ… βœ… βœ…
Observability ❌ βœ… βœ… βœ…
Omni-channel βœ… βœ… βœ… βœ…
Apps βœ… βœ… βœ… βœ…
Wallet ❌ ❌ βœ… βœ…
Vault ❌ βœ… βœ… βœ…
CLI βœ… βœ… βœ… βœ…
API & SDK βœ… βœ… βœ… βœ…
Mobile App ❌ ❌ βœ… βœ…

πŸ€– Agent Availability Matrix

Agent Standalone Docker Cluster Kubernetes Cluster HyperAgency Cloud
Chat ❌ βœ… βœ… βœ…
RAG ❌ βœ… βœ… βœ…
ImageGen βœ… βœ… βœ… βœ…
BrowserUse ❌ βœ… βœ… βœ…
OpenClaw ❌ βœ… βœ… βœ…
Hermes ❌ βœ… βœ… βœ…
Codex ❌ βœ… βœ… βœ…
Claude Code ❌ ❌ ❌ βœ…
STT ❌ βœ… βœ… βœ…
TTS ❌ βœ… βœ… βœ…
Avatar ❌ βœ… βœ… βœ…
Maptrix βœ… βœ… βœ… βœ…
Code ❌ βœ… βœ… βœ…
Command βœ… βœ… βœ… βœ…
Quantum ❌ βœ… βœ… βœ…
Storage βœ… βœ… βœ… βœ…
Transform βœ… βœ… βœ… βœ…
System βœ… βœ… βœ… βœ…
MCP βœ… βœ… βœ… βœ…
A2A βœ… βœ… βœ… βœ…
Curl βœ… βœ… βœ… βœ…
Langflow ❌ βœ… βœ… βœ…
Node-RED ❌ βœ… βœ… βœ…
N8n ❌ βœ… βœ… βœ…
Notebook ❌ βœ… βœ… βœ…

πŸŒ‰ Bridge Availability Matrix

Bridge Standalone Docker Cluster Kubernetes Cluster HyperAgency Cloud
Messengers ❌ βœ… βœ… βœ…
Email βœ… βœ… βœ… βœ…
Phone ❌ ❌ βœ… βœ…
Scheduler βœ… βœ… βœ… βœ…
Webhooks Server βœ… βœ… βœ… βœ…
A2A Server βœ… βœ… βœ… βœ…
MCP Server βœ… βœ… βœ… βœ…
Web App (Lowdefy) ❌ βœ… βœ… βœ…
XMPP Server βœ… βœ… βœ… βœ…

☁️ Fastest Start (No Self-Hosting)

If you don’t want to manage infrastructure, just use the hosted version of HyperAgency Cloud (SaaS Self-Serve).

πŸ‘‰ HyperAgency Cloud (SaaS) https://h9y.ai

No Docker, no Kubernetes, no setup β€” just create an account and start using agents immediately.


πŸ“¦ Installation

You can self-host HyperAgency locally in just a few steps β€” or skip the setup entirely and use our cloud environment for a faster start.

🧰 Prerequisites

To run HyperAgency locally, install the following:


Install Option A: Quick Start (Install Standalone)

Quick start:

docker run \
  -p 3990:3990 -p 6369:6369 -p 6370:6370 -p 5280:5280 \
  -v h9y-standalone-volume:/var/lib/ \
  ghcr.io/vuics/h9y-standalone:v1.39.0

# Or use latest image:
#   ghcr.io/vuics/h9y-standalone:latest

Open localhost:3990 in the browser and start using standalone h9y.

Install Option B: Install Docker Cluster

mkdir hyperagency
cd hyperagency/

curl -fsSL https://raw.githubusercontent.com/vuics/h9y/refs/heads/main/install.sh | sh

# RECOMMENDED: Generate TLS certificates.
#   (Otherwise, use your own certificates.)
./gen-certs.sh

# OPTIONALLY: Setup DNS with /etc/hosts
./setup-hosts.sh

Run:

docker compose up

After you started the stack, you can open in the browser:

App Name URL
App h9y.localhost
API api.h9y.localhost
Vault vault.h9y.localhost
Langflow langflow.h9y.localhost
Nodered nodered.h9y.localhost

NOTE: Replace h9y.localhost with your ${DOMAIN}.

πŸ”‘ Initialize Vault

  1. Open Vault (replace h9y.localhost with your ${DOMAIN}), and input: β€’ Key shares: 1 β€’ Key threshold: 1
  2. Set the env vars with displayed initial root token and the keys in the .env file in the format:
VAULT_TOKEN=(Initial root token)
VAULT_UNSEAL_KEYS=(Key 1)
  1. Unseal the vault by inputing the key, and sing into vault with the initial root token.
  2. Enable new engine with type KV (kv-v2) and path secret.
  3. Restart Docker Compose.
docker compose down
docker compose up

πŸ‘₯ Compose Profiles (Docker Cluster Only)

HyperAgency ships with predefined Docker Compose profiles that let you start small, scale fast, and run exactly what you needβ€”no more, no less. Profiles align the platform with your intent, from first exploration to a full, production-grade agentic stack.

Profile Name Description
try Minimal, zero‑friction setup to explore HyperAgency (default). Ideal for first‑time users, quick demos, and experiments.
h9y Core HyperAgency services included in the h9y repository. Best for active development and local iteration.
all Complete HyperAgency Cloud stack, mirroring the services available at HyperAgency Cloud.

You can find the exhaustive list of available profiles in the docker-compose.yaml.

βš™οΈ Selecting a Profile

Choose the profile that matches your current goal by setting it in the .env file:

COMPOSE_PROFILES=h9y

You can enable multiple profiles and Docker Compose will merge them into a single runtime configuration:

COMPOSE_PROFILES=try,logs,metrics

Then start HyperAgency using Docker Compose as usual. Docker will run only the services associated with the selected profiles.

🎬 Watch Simple Install Video on YouTube

Watch the Simple Install Video


Install Option C: Kubernetes Cluster (Enterprise Self-Hosted)

Recommended for enterprise-grade deployments, high availability, and production-scale infrastructure.

Deploy HyperAgency on your own Kubernetes infrastructure using our official Helm chart.

What you get:

  • Full Kubernetes-native deployment
  • Horizontal scaling of agents and services
  • Production-grade observability integration
  • Secure secrets management (Vault / external KMS)
  • Multi-node distributed execution

Installation

πŸ“¦ Helm chart and documentation provided upon request.

# Contact us to receive:
# - Helm chart (private or enterprise repo)
# - Cluster architecture guide
# - Production deployment instructions

πŸ“© Request access: artem@h9y.ai


Install Option D: Managed Private Cloud (HyperAgency Deployed for You)

Best for teams who want HyperAgency in production without managing infrastructure.

We deploy and operate a dedicated HyperAgency instance tailored to your environment.

What you get:

  • Dedicated cloud or hybrid deployment
  • Custom configuration and integrations
  • Continuous updates and maintenance
  • Enterprise SLA (on request)
  • Private tenant isolation

Includes:

  • Custom agents setup
  • API integrations
  • Observability dashboards
  • Optional custom development

πŸ“© Contact us for deployment: artem@h9y.ai


Install Option E: HyperAgency Cloud (SaaS Self-Serve)

Fastest way to start using HyperAgency β€” no setup required.

Access HyperAgency directly via our hosted platform:

🌐 https://h9y.ai

What you get:

  • Fully managed SaaS version
  • Instant onboarding (no Docker / Kubernetes)
  • Preconfigured agent ecosystem
  • Web dashboard + chat interface
  • Regular updates and new features

Ideal for:

  • Early experimentation
  • Product evaluation
  • Teams without DevOps resources
  • Fast prototyping of agent workflows

πŸ‘‰ Create an account and choose a subscription plan: https://h9y.ai/signup


🎬 Watch Usage Video on YouTube

Watch Usage Video


πŸ—οΈ Build from Source

Build Option 1: Build Standalone from Repo

git clone git@github.com:vuics/h9y.git
cd h9y
docker-compose -f standalone.yml build
docker-compose -f standalone.yml up

Open localhost:3990 in the browser and start using standalone h9y.


Build Option 2: Build Docker Cluster from Repo

πŸ“¦ 1. Clone the Repository with Submodules

git clone git@github.com:vuics/h9y.git
cd h9y

βš™οΈ 2. Configure .Env Files

Copy and customize .env files for the main platform and submodules:

cp env.example .env

πŸ” 3. Generate TLS Certificates

./gen-certs.sh

On macOS, double-click each .crt file in ./certs/ to trust them in Keychain Access.

🌐 4. Configure Local DNS (Optionally)

If your domain is h9y.localhost or anything on localhost, you may not need to configure the DNS, since the locahost often resolves to 127.0.0.1 automatically.

If your domain name does not resolve, set up /etc/hosts entries:

sudo ./setup-hosts.sh

🧱 5. Start the Stack

Use Docker Compose to start all services:

docker-compose up

Open vault.h9y.localhost in the browser to unlock Vault. Vault is used for secure storage of keys, see the section "Initialize Vault" abovefor more details.

Open h9y.localhost in the browser. To unlock Vault for secure storage of keys, see the section "Initialize Vault" above.

πŸ›‘ 6. Stop the Stack

docker-compose down

🧠 Software (Source Code) Licensing

The HyperAgency source code is available under a multi-license model, allowing you to choose the license that best fits your use case.

Use Case License
Free for personal, educational, non-commercial use Apache-2.0-NC
Free for commercial projects that remain open-source AGPL-3.0
Required for commercial closed-source, proprietary use, or SaaS offerings Commercial License

Answers on the most frequent licensing questions are listed in Licensing FAQ.

For commercial licensing inquiries, contact artem@h9y.ai.

⚠️ HyperAgency name and logo are trademarked. See TRADEMARK.md.


πŸ’Ό Paid Pilot / Early Access

HyperAgency isn’t just for experimentation β€” you can run real production-grade agentic systems in your environment under founder-led guidance.

Our 2–3 week pilot programs are designed to answer one critical question:

Can persistent, governed agents replace fragile AI automations in your organization?

🏁 What You’ll Get

  • Live HyperAgency deployment in cloud or self-hosted environment
  • 1–2 production-grade agentic systems solving a real operational problem
  • Persistent memory, coordination, and observability running end-to-end
  • Clear governance points with human approvals, audit logs, and permissions
  • Concrete go / no-go decision for scaling agentic AI in your org

πŸ“… Pilot Options

Duration Scope
2 Weeks Proof of viability with 1 agentic map (1–5 agents)
3 Weeks Operational readiness with 2 agentic maps (up to 10 agents + bridges)

All pilots are hands-on, production deployments β€” not demos or slides.

πŸš€ Apply Now

Apply for a Paid Pilot

Early participation lets you shape your autonomous workflows, get direct collaboration with the HyperAgency team, and jumpstart your agentic AI adoption.


Launch Map


🎯 Conclusion

HyperAgency is an evolving framework for building agentic, autonomous systems β€” and eventually, fully autonomous software companies.

It already offers powerful capabilities for orchestrating agents, coordinating distributed systems, and integrating LLMs and humans in real-time workflows. By joining early, you can contribute to defining what autonomous organizations of the future look like.

πŸ” Explore. 🀝 Collaborate. πŸš€ Build. Build your autonomous AI organization today β€” from fragile AI to living, compound intelligence systems.

πŸ“ž Contact & Community

About

HyperAgency (h9y.ai) is agentic AI operating system that replaces brittle automations with long-lived, self-improving systems that remember, adapt and act on your behalf.

Topics

Resources

License

Unknown, Unknown licenses found

Licenses found

Unknown
LICENSE
Unknown
LICENSE-COMMERCIAL

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages