catwalk

catwalk is a model wrapping and serving platform.

This README contains technical information about the python package. For User documentation, please refer to the Wiki.

Project overview

catwalk provides a simple and automated method to wrap a generic python-based model into a production- ready, dockerised REST API server. The project aims to automatically wrap a model via a CI/CD pipeline, or locally with a CLI, in a simple and flexible way and with a single point of configuration. This model image can then be integrated and deployed into cloud services.

Note that at the time of writing, CD into a cloud service is out-of-scope for catwalk.

Folder structure

• catwalk - Contains the catwalk python module itself.
• example_models - Contains example models for testing and starting points users can use as a basis for their own model.
• tests - Contains the unit test suite for catwalk.
• tutorials - Contains code for various catwalk tutorials.

Documentation

Documentation can be found on the catwalk wiki and on the catwalk GitHub page.

Quick start

1. Install the lb-catwalk package with pip: pip install lb-catwalk
2. Implement a model.py and model.yml following the correct interface, or use one of the example models in example_models.
3. Test your model with catwalk test-model and catwalk test-server.
4. Serve your model with catwalk serve --debug.
5. (Optional) Build a model server image with catwalk build-prep and catwalk build.
6. (Optional) Test the built image with catwalk test-image.
7. (Optional) Deploy with catwalk deploy-prep and docker-compose up.

Setup

The simplest way to install catwalk is via pip:

$ pip install lb-catwalk

To contribute code to the module, clone this repo and install it in "editable" mode in a venv.

(catwalk-venv) $ pip install --editable .

Running the tests

This project uses tox to specify tests and environments.

We don't include tox in the module's requirements, so if you must install it separately:

$ pip install tox

Then, the test suite can be simply run with tox:

$ tox

Integration with docker

The catwalk build command builds docker images, but won't work unless you have docker installed and configured on your machine. If you'd like to use these features, you must setup docker first.

License

Copyright 2020 Leap Beyond Emerging Technologies B.V.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.