Skip to content
/ h9y Public

HyperAgency (h9y.ai) is agentic AI operating system that replaces brittle/fragmented automations with long-lived, self-improving systems. Open-source, self-host & cloud, omni-channel, decentralized, web3 marketplace.

License

Unknown, Unknown licenses found

Licenses found

Unknown
LICENSE
Unknown
LICENSE-COMMERCIAL
Notifications You must be signed in to change notification settings

vuics/h9y

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐙 HyperAgency (h9y.ai)

HyperAgency Text Logo

Website Docs Contribute License Pilot Program

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.


🚀 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.


🌟 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.

🧩 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
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.


⚙️ 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.


💬 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.


🧭 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

🌐 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

🏪 Web3 Marketplace

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

📦 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:


☁️ Prefer Not to Self-Host?

If you don’t want to manage infrastructure yourself, you can request access to our hosted HyperAgency Cloud, where everything is pre-configured and ready to use.

👉 Get Cloud Access

The cloud environment is perfect for early testing, team collaboration, or demoing agentic flows without running Docker or Vault locally.


Option A: Simple Install

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

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


Option B: Install from Repo

📦 1. Clone the Repository with Submodules

git clone git@github.com:vuics/h9y.git
cd h9y
git submodule update --init --recursive

⚙️ 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

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: 5 • Key threshold: 3
  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),(Key 2),(Key 3),(Key 4),(Key 5)
  1. Unseal the vault by inputing 3 of the keys, 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

🛑 Stop the Stack

docker-compose down

👥 Compose Profiles

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.


🙏 Acknowledgements

Special thanks to Hal Casteel and William McKinley for their early ideas, feedback, and discussions. Their insights into intelligent systems and automation inspired much of what became HyperAgency.


📜 Licensing Overview

HyperAgency follows a clear separation between software licensing and brand ownership. This ensures maximum openness for developers while protecting the HyperAgency identity and trust.

🧠 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
Personal, educational, non-commercial use Apache-2.0-NC
Commercial projects that remain open-source AGPL-3.0
Commercial closed-source or proprietary use Commercial License

Choose the license that matches your use:

  • Apache-2.0-NC – Free for personal, educational, and non-commercial usage
  • AGPL-3.0 – Free for commercial use if modifications remain open-source
  • Commercial License – Required for proprietary, closed-source, or SaaS offerings

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

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

🛡️ Brand, Name & Logo (Trademark Protection)

The HyperAgency name, logo, and visual identity are NOT covered by the open-source licenses above.

They are protected under trademark law and governed by the
➡️ HyperAgency Trademark Policy.

This means:

  • ✅ You may use, install, modify, and distribute the code according to its license
  • ❌ You may NOT use the HyperAgency name or logo in ways that imply official endorsement, ownership, or affiliation unless explicitly permitted

This separation protects users from confusion while keeping the software ecosystem open and extensible.

In short: Open code encourages innovation. Protected branding ensures trust.


💼 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.


🎯 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/fragmented automations with long-lived, self-improving systems. Open-source, self-host & cloud, omni-channel, decentralized, web3 marketplace.

Topics

Resources

License

Unknown, Unknown licenses found

Licenses found

Unknown
LICENSE
Unknown
LICENSE-COMMERCIAL

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

No packages published