README.md
Keploy 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:
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.)
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
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
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.
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.
🌐 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
🎭 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
📚 Mock Registry: Centralized registry to manage, reuse, and version mocks across teams and environments. Read more
curl --silent -O -L https://keploy.io/install.sh && source install.sh
Start your app under Keploy to convert real API calls into tests and mocks.
keploy record -c "CMD_TO_RUN_APP"
Example for Python:
keploy record -c "python main.py"
Run tests offline without external dependencies.
keploy test -c "CMD_TO_RUN_APP" --delay 10
Because Keploy intercepts at the network layer (eBPF), it works with any language, framework, or runtime—no SDK required.
<p align="center"> <!-- Languages --> <!-- Protocols & infra commonly virtualized --> </p>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.
Want a guided walkthrough, dedicated support, or help planning enterprise rollout?
<p> <a href="https://calendar.app.google/4ZKd1nz9A5wLuP4W7"> </a> <a href="https://join.slack.com/t/keploy/shared_invite/zt-357qqm9b5-PbZRVu3Yt2rJIa6ofrwWNg"> </a> <!-- Optional: replace with your scheduling link (Cal.com/Calendly) --> <!-- <a href="https://cal.com/keploy/demo"></a> --> </p>Prefer a calendar invite? Mention your availability in the email—we’ll send a calendar invite right away.
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.