Skip to content

docs: add CI badges and Linux platform note #14

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
benvinegar merged 1 commit into from
Feb 17, 2026
Merged

docs: add CI badges and Linux platform note #14

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,14 @@
# 🐝 Hornet

[![CI](https://github.com/modem-dev/hornet/actions/workflows/ci.yml/badge.svg)](https://github.com/modem-dev/hornet/actions/workflows/ci.yml)
[![Integration](https://github.com/modem-dev/hornet/actions/workflows/integration.yml/badge.svg)](https://github.com/modem-dev/hornet/actions/workflows/integration.yml)

**Hardened autonomous agent infrastructure. Careful — you might get stung.**

Hornet is an open framework for running always-on AI agents that support software teams — coding agents, automated SREs, QA bots, monitoring, triage, and more. Agents run as isolated Linux processes with defense-in-depth security. Hornet assumes the worst: that an agent *will* be prompt-injected, and builds kernel-level walls that hold even when the LLM is fully compromised.

**Built for Linux.** Hornet uses kernel-level features (iptables, `/proc` hidepid, Unix users) that don't exist on macOS or Windows. Every PR is integration-tested on fresh **Ubuntu 24.04** and **Arch Linux** droplets.

## Why

Every AI agent framework gives the model shell access and hopes for the best. Hornet doesn't hope — it enforces:
Expand All @@ -16,6 +21,15 @@ Every AI agent framework gives the model shell access and hopes for the best. Ho

Agents work on real files in real repos — no sandbox friction. They make real git branches, run real tests, and push real PRs. But they can't exfiltrate data, escalate privileges, or phone home.

## Requirements

| | Minimum | Recommended |
|--|---------|-------------|
| **OS** | Ubuntu 24.04 or Arch Linux | Any systemd-based Linux |
| **RAM** | 4 GB (3 agents) | 8 GB (6 agents + builds/tests) |
| **CPU** | 2 vCPU | 4 vCPU |
| **Disk** | 20 GB | 40 GB+ (repos, node_modules, Docker images) |

## Quick Start

```bash
Expand Down