# h2non/toxy

Hackable HTTP proxy for resiliency testing and simulated network conditions

Repository: https://github.com/h2non/toxy
Canonical: https://ross.abutalabs.com/products/toxy
Language: JavaScript
License: MIT
License Family: permissive
Topics: http-proxy, proxy, reactive, failure, simulation, network, resiliency, failover, testing, retry
Archived: true
Last push: 2022-02-17T16:26:15+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4053, "days_push": 1658, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2715, forks 80 (observed 2026-08-28T04:07:12.009494+00:00)

## What it is
Toxy is a hackable HTTP proxy for Node.js that simulates server failures and adverse network conditions for resiliency testing. It injects 'poisons' like latency, bandwidth limits, timeouts, and error responses, optionally filtered by rules, and can be used programmatically, via an HTTP API, or as connect/express middleware.

## Use cases
- simulate network latency and jitter in http requests
- test microservice fault tolerance with failure injection
- chaos test my api by injecting errors and timeouts
- rate limit and throttle bandwidth through a proxy
- simulate server failures for resiliency testing
- act as a man-in-the-middle proxy between services to inject faults

## When to choose
- you need to fault-inject HTTP traffic between services to test resiliency
- you want a programmable Node.js proxy with pluggable failure behaviors
- you need to simulate slow networks, timeouts, or error responses in tests

## When to avoid
- you need a maintained tool - it is explicitly unmaintained and may break on modern Node.js
- you need a general-purpose production proxy rather than a testing tool
- you need non-HTTP protocols or L3/L4-level network emulation

## Facets
- artifact type: library
- maturity: abandoned
- function: proxy, testing, http-server, middleware, rate-limiting, load-testing
- domain: testing, networking, developer-tools, apis, microservices
- platform: cli
- tags: chaos-engineering, fault-injection, resiliency-testing, http-proxy, network-simulation, mitm-proxy, unmaintained, nodejs, web-server

## Member repositories
- h2non/toxy (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:12.009494+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:15:30.705443+00:00, confidence not recorded.
  - readme: https://github.com/h2non/toxy (fetched 2026-08-28T04:07:12.009494+00:00, sha be8c41f363c2)
  - registry_npm: https://registry.npmjs.org/toxy (fetched 2026-08-29T09:58:50.523254+00:00, sha e20adecc5c73)
- Data as of 2026-08-30T08:39:29.467469+00:00.