# plabayo/rama

modular service framework to move and transform network packets

Repository: https://github.com/plabayo/rama
Canonical: https://ross.abutalabs.com/products/rama
Homepage: https://ramaproxy.org
Language: Rust
License: Apache-2.0
License Family: permissive
Topics: mitm, network, proxy, rust, tls, http, https, scraping, network-programming, networking
Last push: 2026-09-03T00:15:23+00:00

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

## Adoption (not part of the score)
Stars 1182, forks 103 (observed 2026-09-03T02:15:16.926239+00:00)

## What it is
Rama is a modular service framework for Rust for building network clients, servers, proxies, and traffic inspection tools from composable services, layers, and transports. It also ships a CLI (rama-cli) for HTTP requests with user-agent emulation, proxying, tunneling, and network diagnostics.

## Use cases
- build a custom HTTP or TLS proxy in Rust
- inspect and transform network traffic for security analysis
- emulate browser user agents and TLS fingerprints for scraping
- build an API gateway or reverse proxy
- write high-performance HTTP/1.1 and HTTP/2 servers and clients
- run a MITM proxy to capture and analyze HTTPS traffic
- throttle or track bytes on network streams for testing

## When to choose
- you need programmable, explicit control over the full network stack in Rust
- you are building proxies, traffic inspection, or client-emulation tooling
- you want composable middleware layers similar to tower but network-focused
- you need HTTP/TLS fingerprinting and user-agent emulation

## When to avoid
- you just need a simple web API server with batteries included
- you want a config-driven proxy without writing Rust code
- your team is not comfortable with Rust and async (Tokio) programming
- you need a mature, long-proven framework for critical production web services

## Facets
- artifact type: framework
- maturity: active
- function: http-server, http-client, proxy, middleware, networking, web-framework, cli, security
- domain: networking, web-development, security, developer-tools, backend
- platform: rust, windows, cross-platform, cli
- tags: mitm, tls, http-proxy, traffic-inspection, user-agent-emulation, service-composition, tokio, web-scraping, api-gateway, automation, linux, macos

## Member repositories
- plabayo/rama (main) score 88

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:16.926239+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-30T06:28:18.877381+00:00, confidence not recorded.
  - readme: https://github.com/plabayo/rama (fetched 2026-09-03T02:15:16.926239+00:00, sha 2edba2c7df34)
  - homepage: https://ramaproxy.org (fetched 2026-08-29T12:33:32.681956+00:00, sha b10c52d51193)
  - site_page: https://ramaproxy.org/docs/rama/tcp/index.html (fetched 2026-08-29T12:33:32.689051+00:00, sha 2a0049b4b0f3)
  - site_page: https://ramaproxy.org/docs/rama/udp/index.html (fetched 2026-08-29T12:33:32.690525+00:00, sha 1de794319aca)
  - site_page: https://ramaproxy.org/docs/rama/unix/index.html (fetched 2026-08-29T12:33:32.691949+00:00, sha 704c4a7e82f9)
  - site_page: https://ramaproxy.org/docs/rama/net/stream/layer/index.html (fetched 2026-08-29T12:33:32.693443+00:00, sha 8027568b16b7)
  - site_page: https://ramaproxy.org/docs/rama/http/server/service/struct.HttpServer.html (fetched 2026-08-29T12:33:32.694911+00:00, sha 91ef5003d819)
  - site_page: https://ramaproxy.org/docs/rama/http/layer/index.html (fetched 2026-08-29T12:33:32.696842+00:00, sha bb0da4084f66)
  - registry_crates: https://crates.io/api/v1/crates/rama (fetched 2026-08-29T12:33:32.698733+00:00, sha 6d3150d41347)
  - site_page: https://ramaproxy.org/book/intro/services_all_the_way_down.html (fetched 2026-08-29T12:33:32.685446+00:00, sha 5912437d1782)
- Data as of 2026-08-30T08:39:29.467469+00:00.
