comcast
A tool to simulate common network problems like latency, bandwidth restrictions, and packet loss for testing distributed systems.
What is comcast?
Comcast is a command-line tool that simulates poor network conditions—such as latency, bandwidth restrictions, and packet loss—to help developers test and build more resilient distributed systems. It wraps system-level networking tools like `iptables` and `tc` on Linux or `pfctl` and `ipfw` on BSD/OSX to inject controlled failures into network traffic.
Developers, DevOps engineers, and system administrators working on distributed systems who need to test application behavior under realistic network impairments.
It provides a simple, cross-platform CLI to simulate real-world network issues without manual configuration of low-level tools, making resilience testing accessible and repeatable.
Overview
Simulating shitty network connections so you can build better systems.
Use Cases
Best For
- Testing distributed system resilience under network latency
- Simulating bandwidth restrictions for performance benchmarking
- Introducing packet loss to verify error handling and retry logic
- Validating application behavior on slow or unreliable networks like 3G or DSL
- Creating reproducible network failure scenarios in development or CI/CD pipelines
- Learning how network conditions affect system performance and reliability
Not Ideal For
- Windows environments or teams requiring cross-platform support including Windows
- Scenarios needing advanced network simulation beyond latency, bandwidth, and packet loss, such as custom jitter or corruption patterns
- Systems where root or administrative privileges are unavailable, as Comcast executes low-level system commands
Pros & Cons
Pros
Provides a unified CLI interface for network simulation on Linux and BSD/OSX, abstracting complex tools like tc and iptables into simple commands.
Allows precise application of network conditions to specific IPs, protocols, and ports, as shown in the Linux usage example with --target-addr and --target-proto.
Includes a --dry-run flag to log system commands without execution, reducing risk by letting users verify changes first.
The --stop command quickly reverts all network impairments, minimizing disruption and simplifying cleanup after testing.
Cons
The README explicitly states that Windows implementation is not yet available, limiting its utility in mixed-OS environments.
On BSD systems, Comcast only supports device, latency, bandwidth, and packet loss, unlike Linux which offers additional options like target protocols and ports.
Requires administrative privileges to execute underlying system tools, which can be problematic in containerized or locked-down environments.
Frequently Asked Questions
Related Projects
okhttpA meticulous HTTP client for the JVM, Android, and GraalVM.
gorGoReplay is an open-source tool for capturing and replaying live HTTP traffic into a test environment in order to continuously test your system with real data. It can be used to increase confidence in code deployments, configuration changes and infrastructure changes.
AeronEfficient reliable UDP unicast, UDP multicast, and IPC message transport
SimianArmyTools for keeping your cloud operating in top form. Chaos Monkey is a resiliency tool that helps applications tolerate random instance failures.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.