httprunner

by httprunner

Pending

HttpRunner is an open source API/UI testing framework that is easy to use, powerful, rich in plug-in mechanisms and highly scalable.

4,254stars
1,284forks
Go
Added 12/27/2025
AI Agentsadbagent-tarsmcp-servermcphosttestingui-tarsui-testinguiautomator2wdawebdriveragent
Installation
# Add to your Claude Code skills
git clone https://github.com/httprunner/httprunner
README.md

HttpRunner

Github Actions codecov Go Reference downloads TesterHome

⚠️ HttpRunner v5 仅包含 Golang 版本,Python 版本的代码已迁移至 httprunner/httprunner.py

HttpRunner(简称 hrp) 是一个开源测试框架,诞生于 2017 年,最开始应用于 API 接口、性能测试,后面逐步进化为了一款通用、可拓展的测试框架。

在 2022 年,HttpRunner 开始新增支持 UI 自动化测试,当前已经支持了 Android/iOS/Harmony/Browser 多种系统平台,并在 v5 版本融入了大模型技术,成长成为了一款通用的智能自动化测试框架。

HttpRunner 相比其它 UI 自动化框架,主要特点包括:

  • 采用纯视觉驱动方案(OCR/CV/VLM),追求通用性和尽可能低的性能损耗
  • 多端统一 API,降低学习和横向拓展的成本
  • 拥抱开源生态,充分复用开源组件
  • Golang 技术栈,二进制分发部署

HttpRunner v5 用户指南(更新中) HttpRunner DeepWiki

使用说明

HttpRunner v5 安装完成后,你将获得一个 hrp 命令行工具,执行 hrp -h 即可查看到参数帮助说明。

$ hrp -h

██╗  ██╗████████╗████████╗██████╗ ██████╗ ██╗   ██╗███╗   ██╗███╗   ██╗███████╗██████╗
██║  ██║╚══██╔══╝╚══██╔══╝██╔══██╗██╔══██╗██║   ██║████╗  ██║████╗  ██║██╔════╝██╔══██╗
███████║   ██║      ██║   ██████╔╝██████╔╝██║   ██║██╔██╗ ██║██╔██╗ ██║█████╗  ██████╔╝
██╔══██║   ██║      ██║   ██╔═══╝ ██╔══██╗██║   ██║██║╚██╗██║██║╚██╗██║██╔══╝  ██╔══██╗
██║  ██║   ██║      ██║   ██║     ██║  ██║╚██████╔╝██║ ╚████║██║ ╚████║███████╗██║  ██║
╚═╝  ╚═╝   ╚═╝      ╚═╝   ╚═╝     ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝

HttpRunner: Enjoy your All-in-One Testing Solution ✨ 🚀 ✨

💡 Simple Yet Powerful
   - Natural language driven test scenarios powered by LLM
   - User-friendly SDK API with IDE auto-completion
   - Intuitive GoTest/YAML/JSON/Text testcase format

📌 Comprehensive Testing Capabilities
   - UI Automation: Android/iOS/Harmony/Browser
   - API Testing: HTTP(S)/HTTP2/WebSocket/RPC
   - Load Testing: run API testcase concurrently with boomer

🧩 High Scalability
   - Plugin system for custom functions
   - Distributed testing support
   - Cross-platform: macOS/Linux/Windows

🛠 Easy Integration
   - CI/CD friendly with JSON logs and HTML reports
   - Rich ecosystem tools

Learn more:
Website: https://httprunner.com
GitHub: https://github.com/httprunner/httprunner

Copyright © 2017-present debugtalk. Apache-2.0 License.

Usage:
  hrp [command]

Available Commands:
  adb          simple utils for android device management
  build        Build plugin for testing
  completion   Generate the autocompletion script for the specified shell
  convert      Convert multiple source format to HttpRunner JSON/YAML/gotest/...