Skip to content
Interactive tutorial for getting started with Meeshkan.
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


An interactive tutorial for getting started with Meeshkan.


Install via pip:

$ pip install meeshkan-tutorial

This tutorial has been tested on Python 3.6, 3.7, and 3.8.


After installing, you can begin the tutorial by invoking from the command line:

$ meeshkan-tutorial

Once you've run this, you should see:

                             __    __
   ____ ___  ___  ___  _____/ /_  / /______ _____
  / __ `__ \/ _ \/ _ \/ ___/ __ \/ //_/ __ `/ __ \
 / / / / / /  __/  __(__  ) / / / ,< / /_/ / / / /
/_/ /_/ /_/\___/\___/____/_/ /_/_/|_|\__,_/_/ /_/

The tutorial!!
Press ENTER to continue...

If not, it's probably our fault. Please let us know on the issues page.

What to expect

By the end of this tutorial, you'll know how to use Meeshkan to:

  • Record server traffic from an API
  • Transform those recordings into an OpenAPI spec
  • Create a mock server from the spec

You'll repeat this two times: once to build a mock server that serves back recordings (similar to wiremock or hoverfly), and once to build a mock server that serves back synthetic data (similar to unmock or fast-check). The tutorial will end by showing how these two modes can be mixed.

What is Meeshkan

Meeshkan is a tool for mocking HTTP APIs for use in sandboxes as well as for automated and exploratory testing. It uses a combination of API definitions, recorded traffic and code in order to make crafting mocks as enjoyable as possible.

You can’t perform that action at this time.