Python & PIP

Harp is also installable using a Python package manager (most likely, pip).

Install with PIP

You need a working Python 3.13+ environment with the pip package manager (or another package manager of your choice). To install it, run:

pip install harp-proxy

Start a proxy

Then, you’ll be able to start the server using:

harp-proxy server

This will start the proxy using the default settings (in memory sqlite storage) and by default, the dashboard will be available at http://localhost:4080.

Without configured endpoints, no traffic can be proxied yet. Stop this process and start a server with an endpoint:

harp-proxy server --endpoint httpbin=4000:http://httpbin.org

This will start a new harp server with an additional port that will proxy requests to httpbin.org.

Send some requests through the configured proxy port:

curl -X GET "http://localhost:4000/get" -H "accept: application/json"
curl -X POST "http://localhost:4000/post" -H "accept: application/json"
curl -X PUT "http://localhost:4000/put" -H "accept: application/json"

Open the dashboard at http://localhost:4080 to see the transactions that went through.

Next Steps

Now that you have HARP running:

  • Configure your proxy: Configuration - Learn about endpoint configuration, caching, and advanced settings

  • Explore features: Features Guide - Discover HARP’s capabilities for API reliability and observability

  • Monitor your APIs: /operate/dashboard - Use the dashboard to observe traffic patterns and debug issues