On 2022.01.10

This version has been deprecated. If used with the current API version it can produce unexpected behaviour or errors.

The package shimoku-api-python is no longer maintained

pip install --upgrade shimoku-api-python


  • Indicators s.plt.indicator() are now responsive to Mobile & Tablet.

  • Indicators s.plt.indicator() can have other Reports in the same row.

  • The variable menu_path used for all the s.plt objects now replaces _ for - for html standards


  • The API has an official URL: https://api.shimoku.io/external/v1/

  • The dataset for a Table Report s.plt.table() accepts empty values.

  • For Indicators Report s.plt.indicator() now you can specify how many indicators you want by row with the parameter multi_column

  row=1, column=1,
  multi_column=2,  # It will put 2 indicators by row
  • When a Report is created with s.plt it updates (replaces) what existed in the same grid position before. For instance in the following example you will end up having a Line chart in the position 1, 1 of the β€˜test’ menu path (there would not be sign of a Bar chart in the FE).

  x='date', y=['x', 'y'],
  title='Test Bar test',
  row=1, column=1,

  x='date', y=['x', 'y'],
  title='Test Line test',
  row=1, column=1,

After execute the Bar creation:

After execute it all (the Bar chart has been removed):

Thus s.plt.update() is no longer necessary and is marked to be deprecated.

  • The Barchart Report s.plt.bar() is not creating the X-Zoom by default (which is not an expected behavior for bar-charts in general)

  • The Order of the Paths is by creation order.

In the following example first reports for the path β€˜Overview’ where created, then ' Business detail' and so on…

s.plt.table(menu_path='shimoku-backoffice/overview', ...)
s.plt.bar(menu_path='shimoku-backoffice/business-detail', ...)


  • A method to check if the API is available: s.ping() returns True if the API is alive.

  • The object suite has been created s.suite that creates whole Apps in a single command line. Currently you have the following:

    • Shimoku Backoffice s.suite.shimoku_backoffice() creates a Back Office of your universe.

  • Charts catalog s.suite.charts_catalog() creates an App with all the available Reports in Shimoku.


Through the following weeks we will advance in:

  • The multi-environment (prod & staging).

  • Order all paths in an App a posteriori with s.plt.set_path_orders()

  • Multi filter feature that will allow to apply multiple Filters to all the reports (right now it is only available for Table).

  • Input Reports that accept input data.

  • The following Reports:

    • Cohorts

    • Themeriver

    • Candlestick

    • Scatter with confidence area

    • Line with confidence area

    • Bubble chart

Last updated