keploy · Trending

keploy/keploy

Open-source platform for creating safe, isolated production sandboxes for API, integration, and E2E testing.

View on GitHub Website / Demo Back to listing

18.6kstars 2.4kforks 100+contributors Go

README.md

<h3 align="center">⚡️ API tests faster than unit tests, from user traffic ⚡️</h3>
🌟 The must-have tool for developers in the AI-Gen era for 90% test coverage 🌟

---

[Keploy](https://keploy.io) is a **developer‑centric API and integration testing tool** that auto‑generates **tests and data‑mocks** faster than unit tests.

It records API calls, database queries, and streaming events — then replays them as tests. Under the hood, Keploy **uses eBPF to capture traffic at the network layer,** but for you it’s completely **code‑less** and **language‑agnostic**.

> 🐰 **Fun fact:** Keploy uses itself for testing! Check out our swanky coverage badge: [![Coverage Status](https://coveralls.io/repos/github/keploy/keploy/badge.svg?branch=main&kill_cache=1)](https://coveralls.io/github/keploy/keploy?branch=main&kill_cache=1) &nbsp;

---

# Key Highlights

## 🎯 No code changes

Just run your app with `keploy record`. Real API + integration flows are automatically captured as tests and mocks. *(Keploy uses eBPF under the hood to capture traffic, so you **don’t need** to add any SDKs or modify code.)*

## 📹 Record and Replay complex Flows
Keploy can record and replay complex, distributed API flows as mocks and stubs.  It's like having a very light-weight time machine for your tests—saving you tons of time!

👉 [Read the docs on record-replay](https://keploy.io/docs/keploy-explained/introduction/)

## 🐇 Complete Infra‑Virtualization (beyond HTTP mocks)

Unlike tools that only mock HTTP endpoints, Keploy records **databases** (Postgres, MySQL, MongoDB), **streaming/queues** (Kafka, RabbitMQ), external APIs, and more.

It replays them deterministically so you can run tests without re‑provisioning infra.

👉 [Read the docs on infra virtualisation](https://keploy.io/docs/keploy-explained/how-keploy-works/)

## 🧪 Combined Test Coverage

If you’re a **developer**, you probably care about *statement* and *branch* coverage — Keploy calculates that for you.

If you’re a **QA**, you focus more on *API schema* and *business use‑case coverage* — Keploy calculates that too. This way coverage isn’t subjective anymore.

👉 [Read the docs on coverage](https://keploy.io/docs/server/sdk-installation/go/)

## 🤖 Expand API Coverage using AI

Keploy uses existing recordings, Swagger/OpenAPI Schema to find: boundary values, missing/extra fields, wrong types, out‑of‑order sequences, retries/timeouts.

This helps expand API Schema, Statement, and Branch Coverage.

👉 [Read the docs on coverage](https://app.keploy.io/)

### Other Capabilities

- 🌐 **CI/CD Integration:** Run tests with mocks anywhere you like—locally on the CLI, in your CI pipeline (Jenkins, Github Actions..) , or even across a Kubernetes cluster. [Read more](https://keploy.io/docs/running-keploy/api-testing-cicd/)

- 🎭 **Multi-Purpose Mocks**: You can also use Keploy-generated Mocks, as server Tests!

- 📊 **Reporting:** Unified reports for API, integration, unit, and e2e coverage with insights directly in your CI or PRs.
- 🖥️ **Console:** A developer-friendly console to view, manage, and debug recorded tests and mocks.
- ⏱️ **Time Freezing:** Deterministically replay tests by freezing system time during execution. [Read more](https://keploy.io/docs/keploy-cloud/time-freezing/)
- 📚 **Mock Registry:** Centralized registry to manage, reuse, and version mocks across teams and environments. [Read more](https://keploy.io/docs/keploy-cloud/mock-registry/)

---

## Quick Start

### 1. Install Keploy Agent

```bash
curl --silent -O -L https://keploy.io/install.sh && source install.sh
```

### 2. Record Test Cases

Start your app under Keploy to convert real API calls into tests and mocks.

```bash
keploy record -c "CMD_TO_RUN_APP"
```

Example for Python:

```bash
keploy record -c "python main.py"
```

### 3. Run Tests

Run tests offline without external dependencies.

```bash
keploy test -c "CMD_TO_RUN_APP" --delay 10
```

## Resources
### - 📘 [Installation](https://keploy.io/docs/server/installation/)
### - 🏁 [QuickStarts](https://keploy.io/docs/quickstart/quickstart-filter/)

---

## Languages &amp; Frameworks (Any stack)

Because Keploy intercepts at the **network layer (eBPF)**, it works with **any language, framework, or runtime**—no SDK required. 
> Note: Some of the dependencies are not open-source by nature because their protocols and parsings are not open-sourced. It's not supported in Keploy enterprise.

<img src="https://img.shields.io/badge/Go-00ADD8?logo=go&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Java-ED8B00?logo=openjdk&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Node.js-43853D?logo=node.js&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Python-3776AB?logo=python&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Rust-000000?logo=rust&amp;logoColor=white" />
<img src="https://img.shields.io/badge/C%23-239120?logo=csharp&amp;logoColor=white" />
<img src="https://img.shields.io/badge/C/C++-00599C?logo=cplusplus&amp;logoColor=white" />
<img src="https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Scala-DC322F?logo=scala&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Kotlin-7F52FF?logo=kotlin&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Swift-FA7343?logo=swift&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Dart-0175C2?logo=dart&amp;logoColor=white" />
<img src="https://img.shields.io/badge/PHP-777BB4?logo=php&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Ruby-CC342D?logo=ruby&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Elixir-4B275F?logo=elixir&amp;logoColor=white" />
<img src="https://img.shields.io/badge/.NET-512BD4?logo=dotnet&amp;logoColor=white" />

<img src="https://img.shields.io/badge/gRPC-5E35B1?logo=grpc&amp;logoColor=white" />
<img src="https://img.shields.io/badge/GraphQL-E10098?logo=graphql&amp;logoColor=white" />
<img src="https://img.shields.io/badge/HTTP%2FREST-0A84FF?logo=httpie&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Kafka-231F20?logo=apachekafka&amp;logoColor=white" />
<img src="https://img.shields.io/badge/RabbitMQ-FF6600?logo=rabbitmq&amp;logoColor=white" />
<img src="https://img.shields.io/badge/PostgreSQL-4169E1?logo=postgresql&amp;logoColor=white" />
<img src="https://img.shields.io/badge/MySQL-4479A1?logo=mysql&amp;logoColor=white" />
<img src="https://img.shields.io/badge/MongoDB-47A248?logo=mongodb&amp;logoColor=white" />
<img src="https://img.shields.io/badge/Redis-DC382D?logo=redis&amp;logoColor=white" />

---

## Questions?

### Book a Live Demo / Enterprise Support

Want a guided walkthrough, dedicated support, or help planning enterprise rollout?

Prefer a calendar invite? Mention your availability in the email—we’ll send a **calendar invite** right away.

---

## Documentation & Community

- 📘 [Documentation](https://keploy.io/docs/) — Explore the full docs
- 💬 [Slack Community](https://join.slack.com/t/keploy/shared_invite/zt-3zcnuqfgl-WYK1NMhslVHsCtNcA1ULwA) — Join the conversation
- 📜 [Contribution Guidelines](https://keploy.io/docs/keploy-explained/contribution-guide/)
- ❤️ [Code of Conduct](https://github.com/keploy/keploy/blob/main/CODE_OF_CONDUCT.md)
- 📢 [Blog](https://keploy.io/blog/) — Read articles and updates

---

## Contribute & Collaborate

Whether you're new or experienced, your input matters. Help us improve Keploy by contributing code, reporting issues, or sharing feedback.

Together, let's build better testing tools for modern applications.

Repository info

Default branch: main
Latest version: v3.6.125
Created: 2022-01-19
Last activity: 2026-10-14
License: Apache-2.0
Open issues: 789
Watchers: 48

Topics

agentic-ai ai-testing-tool api-testing code-quality mock mock-data-generator mock-framework test-automation test-automation-framework test-generation testing testing-library testing-tool testing-tools

Contributors

slayerjain

465 contributions

gouravkrosx

166 contributions

charankamarapu

119 contributions

shivamsouravjha

97 contributions

re-Tick

96 contributions