HARP — HTTP API Runtime Proxy

HARP Proxy is a forward proxy sitting between your application(s) and remote APIs, to improve their reliability, performances, and security. It adds builtin observability features via its dashboard and monitoring, and reduces the amount of userland code required for common HTTP-related, non-business features. Whether you are in the development phase or ready for production, HARP serves as a handy companion for API consumers.

Start Guide Install and run your first proxy. Quick start Using Docker Using Python From Sources
Features Guide Discover HARP Proxy, feature by feature. Configuration Proxy Cache Circuit Breaker Probes Audit Log Rules Engine
User’s Guide Explore the user interface. Overview Transactions System Performances	Operator’s Guide Configure and watch. Configuration Run
Developer’s Guide Enhance and extend. Quick start Run Customize Extend	Contributor’s Guide Dive in the internals. Introduction Overview Dependency Injection Events Applications
Reference Exhaustive reference list and description of commands, functions, classes, settings, etc. Core Reference Applications Reference Configuration Reference Command Line Reference

HARP at a glance

• Open-source and self-hosted, in your infrastructure

• Written in Python using asyncio, httpx and hishel (amongst other)

• Provides caching, circuit breaking and full observability without a single line of code

Table of Content

• Getting Started
  • Quick start
  • System Requirements
  • Installation
  • What next?

Guides

• Features Guide
  • Configuration
  • Dashboard
  • Proxy
  • Audit Log
  • Caching
  • Circuit Breaker
  • Rules Engine
• User Guide
  • Overview
  • Transactions
  • System
  • Performances
• Operator Guide
  • Configuration
  • Database Migrations
  • Logging
  • Prometheus
  • Run
• Developer guide
  • Quick start
  • Run
  • Customize
  • Extend
• Contributor Guide
  • Introduction
  • Setup
  • Overview
  • Dependency Injection
  • Applications
  • Events
  • Makefile
  • Storage
  • Dashboard
  • Testing
  • Releasing

Reference

• Core Reference
  • Events
  • Services
  • Internals
• Applications Reference
  • Dashboard
  • HTTP Cache
  • HTTP Client
  • Janitor
  • Metrics
  • Notifications
  • Proxy
  • Rules
  • Storage
• Configuration Reference
  • Dashboard
  • HTTP Client
  • Proxy
  • Storage
• Command Line Reference
  • harp
  • How to use

Miscellaneous

• Changelogs & History
  • Unreleased
  • Version 0.10.0 (2025-12-04)
  • Version 0.9.1 (2025-11-02)
  • Version 0.9.0 (2025-10-31)
  • Version 0.8.1 (2025-04-24)
  • Version 0.8.0 (2025-04-23)
  • Version 0.7.7 (2024-11-16)
  • Version 0.7.6 (2024-11-03)
  • Version 0.7.5 (2024-11-03)
  • Version 0.7.4 (2024-10-30)
  • Version 0.7.3 (2024-10-28)
  • Version 0.7.2 (2024-10-24)
  • Version 0.7.1 (2024-09-17)
  • Version 0.7.0 (2024-09-17)
  • Older Changelogs
• Frequently Asked Questions
  • Cookbook
  • Internal development related questions

Indices and tables

• Index

• Module Index

• Tags overview

• Search Page