Moku

A Python library for the command, control and monitoring of the Liquid Instruments Moku:Go.

Official documentation for this library is available on the Moku API documentation page, and includes more information on getting started, tutorials and examples.

Getting Started

1. Requirements

• Python >= 3.8 installed
• Your Moku connected to the same network as your computer
• Internet access

2. Install dependencies

mokucli

The mokucli utility is required for device discovery and data streaming. Download and install it from the Moku Utilities page.

After installation, verify it works by listing Moku devices on your network:

mokucli list

Python package

Open a command-line terminal and install the Moku Python library:

pip install --upgrade moku

Or using uv (faster):

uv pip install --upgrade moku

If you wish to build and train models for the Moku Neural Network instrument, install optional machine learning dependencies:

pip install "moku[neuralnetwork]"
# or with uv:
uv pip install "moku[neuralnetwork]"

3. Using the moku CLI tool

The mokucli utility can be used to download instrument definitions:

mokucli instrument download <version>

This downloads the latest instrument definitions for the specified Moku OS version.

4. Start scripting

You are now ready to control your Moku:Go using Python! You can find a few example scripts in the examples/ folder. Here is a basic example of how to connect to a Moku:Go, deploy the Oscilloscope and fetch a single hi-res data trace. Open python and run the following code

from moku.instruments import Oscilloscope

# Connect to your Moku by its ip Oscilloscope('192.168.###.###')
# or by its serial m = Oscilloscope(serial=123)
i = Oscilloscope('192.168.###.###', force_connect=False)

try:
    # Span from -1s to 1s i.e. trigger point centred
    i.set_timebase(-1, 1)

    # Get and print a single frame worth of data (time series
    # of voltage per channel)
    data = i.get_data()
    print(data['ch1'], data['ch2'], data['time'])
except Exception as e:
    print(f'Exception occurred: {e}')
finally:
    i.relinquish_ownership()

Debug Logging

The Moku library includes built-in logging support for debugging connection issues and monitoring API calls. By default, the library does not produce any log output. To enable debug logging:

import moku.logging

# Enable debug logging to stderr
moku.logging.enable_debug_logging()

# Your Moku code here - all operations will be logged
from moku.instruments import Oscilloscope
osc = Oscilloscope('192.168.###.###')

# Disable logging when done
moku.logging.disable_debug_logging()

For temporary debugging, use the context manager:

import moku.logging

with moku.logging.LoggingContext():
    # Debug logging only enabled within this block
    osc = Oscilloscope('192.168.###.###')
    # ...

See examples/logging_debug.py for more detailed examples.

Troubleshooting

moku: command not found

Ensure moku has been successfully installed in your Python distrubution by open a python shell and running

import moku

No error indicates a successful install.

You may need to add python binaries to your PATH. This varies with operating system and python version but as an example

export PATH=$PATH:/home/user/.local/bin

ImportError: No Module named moku

Make sure you are running the version of Python you installed moku to. Often a system will have multiple Python installations. Try substituting pip with python -m pip in the installation. If you installed moku inside an Environment (i.e. via virtualenv or conda-env), ensure that Environment is activated. You can check that moku is installed in your currently running environment using

(myenv)$ pip list

Issue Tracking

Please report issues at https://www.liquidinstruments.com/support/contact/