keploy

Active
GitHub Go Apache-2.0

Description

Keploy is an open-source sandbox platform for API and E2E testing that records and replays real traffic inside an isolated environment to generate test cases.

Key Features

  • Traffic record-and-replay - capture real API calls including requests, responses, and dependencies as runnable test cases
  • Dependency mocking - intercept databases, HTTP calls, and Kafka topics and replace them with deterministic mocks
  • Time freeze and clock control - freeze system time inside the test sandbox for time-sensitive logic
  • Multi-language SDKs - Go, Java, Node.js, and Python libraries for the most common web frameworks
  • CI-native integration - run regressions zero-config in GitHub Actions, GitLab CI, and Jenkins
  • Kubernetes Operator - keploy-operator manages test sandboxes centrally inside a K8s cluster

Use Cases

💡 Auto-generate regression suites for microservice APIs and run them in parallel inside CI
💡 Sample production traffic and replay it deterministically in staging
💡 Run new DB migration scripts inside a sandbox and diff the outcome automatically
💡 Provide isolated, replayable test environments for AI agents that hit external APIs
💡 Test cron jobs, scheduled tasks, and time-sensitive billing flows with time frozen

Quick Start

# Launch the Keploy sandbox on Linux via the prebuilt binary
curl -O https://raw.githubusercontent.com/keploy/keploy/main/keploy_linux_amd64.tar.gz
tar -xvzf keploy_linux_amd64.tar.gz

# Record real traffic from a Node.js app
keploy record -c "node app.js"

# Replay inside the sandbox and generate the test report
keploy test -c "node app.js" --goCoverage

# Or try it through Docker Compose
git clone https://github.com/keploy/keploy.git
cd keploy
docker compose up

Related Projects