Sources

To install from sources, you’ll need git, uv and make available.

Note

Python 3.13 Required

HARP 0.9+ requires Python 3.13. UV will automatically manage the correct Python version, but ensure UV itself is installed on your system.

Clone the repository, then in its directory run:

make install-dev
uv run harp-proxy server

The make install-dev command installs all development dependencies including frontend tooling (Node.js/pnpm) and sets up pre-commit hooks. The project’s pyproject.toml specifies Python 3.13 as a requirement, and UV will use the correct version automatically.

Note

Docker Required for Tests

Running the full test suite requires Docker, as tests use testcontainers to spawn database instances (PostgreSQL, MySQL).

Development Workflow

For detailed information on contributing, testing, and development workflow, see Contributor Guide.

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