← 开源
h5i-dev

h5i

An agent-native web security workspace. Find vulnerabilities through red-teaming. Formally verify properties of Rust codes in Lean 4.

InfrastructureObservabilityMake world agent-readyRust
在 GitHub 打开
增长势头
+324 小时新增 Star+0.4%
703
Star
68
Fork
+30
本周
22
贡献者
创建于 2026-03-11 · 更新于 2026-10-11 · 今日第 2580 名
主要开发者
README

h5i logo

tests Apache-2.0 GitHub stars release

The Agent-Native Web Security Workspace

h5i (pronounced high-five) is a workspace for securing web applications through two complementary approaches: finding vulnerabilities with AI agents and proving correctness with formal verification.

  • Find Bugs (Red-Teaming): Give AI agents a unified toolkit for browser automation, HTTP traffic manipulation, and reconnaissance. Test existing web applications for vulnerabilities, reproduce attacks, and run security regression checks in CI/CD.
  • Prove Correctness (Formal Verification): Build applications with h5i-app, an Axum-based Rust framework designed for verification with Lean 4. Prove authorization, data isolation, and business logic properties directly against your Rust implementation.

Build with agents. Red-team for bugs. Formally verify properties.

# Find bugs in web applications
h5i browser open https://example.com                    # Open a website in the browser
h5i browser click @e3                                   # Interact with page elements
h5i websec requests                                     # Inspect captured HTTP traffic
h5i websec replay req_42 --set query.id=456             # Modify and replay a request
h5i recon crawl --max-requests 200                      # Crawl the application for attack surfaces

# Prove correctness of Rust application logic
h5i app new counter && cd counter                       # Create an h5i-app project
h5i app extract                                         # Translate Rust logic into Lean 4
h5i app prove                                           # Build and check formal proofs
h5i app mutate                                          # Test proof sensitivity with mutations

h5i on Trendshift


1. Install

curl -fsSL https://h5i.dev/install.sh | sh -s -- --websec --recon --test         # `websec`, `recon`, and `test` are optional plugins
# curl -fsSL https://raw.githubusercontent.com/h5i-dev/h5i/main/install.sh | sh  # if you would rather not add a domain to the chain:
# cargo install --path .                                                         # build from source
# h5i plugin list                                                                # says what is installed

The agent-facing interface is a skill, and the binary carries it:

npx skills add h5i-dev/h5i         # if you do not have the binary yet
# h5i skill install                # writes it where your runtime looks

2. Find Bugs: Red-Team with Agents

Let AI agents explore, attack, and test web applications using h5i's integrated security toolkit.

h5i works with any web services regardless of their framework, and no migration to h5i-app is required.

  • Browser automation: Navigate applications, interact with forms, and test authenticated workflows.
  • HTTP security testing: Capture, modify, replay, and compare HTTP requests to investigate vulnerabilities.
  • Recon: Discover endpoints, parameters, and hidden attack surfaces through crawling and JavaScript analysis.
  • Reproducible testing: Save confirmed attack flows and replay them in CI/CD to catch security regressions.
  • Sandboxed workflow: Run agents in isolated environments with configurable filesystem and network restrictions.

Agents access these capabilities through a unified CLI. You can also monitor their activity through the dashboard:

h5i ui    # Open the local dashboard

h5i local dashboard showing browser and session activity

See the CLI manual for complete documentation and the CI regression example for automated security testing.


3. Prove Correctness: Build on h5i-app

h5i-app is an Axum-based Rust web framework that makes application logic amenable to Lean 4.

Red-teaming discovers bugs through testing. Formal verification takes a complementary approach: proving that specified properties hold for all possible inputs and behaviors.

[dependencies]
h5i-app = { version = "0.1.1", features = ["http", "postgres"] }

We can write web applications in Rust, translate them into Lean 4 via Aeneas, and prove various properties like authorization, isolation, business logics, and more.

Watching a sandboxed browser session from the host

See the h5i-app documentation for a complete example, the Axum integration, and the formal verification workflow.


4. Documentation

  • Official Website: project overview, Slides
  • MANUAL.md / man h5i: full command reference
  • CONTRIBUTING.md: we welcome contributions of any kind
  • curl -fsSL https://h5i.dev/man/man1/h5i.1 -o ~/.local/share/man/man1/h5i.1: install the man page

5. License

h5i is licensed under the Apache License 2.0. See LICENSE.


6. Contributors

h5i contributors