XWalways / serverless-template

🍌 Banana Serverless

This repo gives a basic framework for serving ML models in production using simple HTTP servers.

If you want to generalize this to deploy anything on Banana, see the guide here.

Quickstart:

The repo is already set up to run a basic HuggingFace BERT model.

1. Run pip3 install -r requirements.txt to download dependencies.
2. Run python3 server.py to start the server.
3. Run python3 test.py in a different terminal session to test against it.

Make it your own:

1. Edit app.py to load and run your model.
2. Make sure to test with test.py!
3. When ready to deploy:

• edit download.py (or the Dockerfile itself) with scripts download your custom model weights at build time
• edit requirements.txt with your pip packages. Don't delete the "sanic" line, as it's a banana dependency.

Move to prod:

At this point, you have a functioning http server for your ML model. You can use it as is, or package it up with our provided Dockerfile and deploy it to your favorite container hosting provider!

If Banana is your favorite GPU hosting provider (and we sure hope it is), read on!

🍌

Deploy to Banana Serverless:

Three steps:

1. Create your own copy of this template repo. Either:

• Click "Fork" (creates a public repo)
• Click "Use this Template" (creates a private or public repo)
• Create your own repo and copy the template files into it

2. Install the Banana Github App to your new repo.

3. Login in to the Banana Dashboard and setup your account by saving your payment details and linking your Github.

From then onward, any pushes to the default repo branch (usually "main" or "master") trigger Banana to build and deploy your server, using the Dockerfile. Throughout the build we'll sprinkle in some secret sauce to make your server extra snappy 🔥

It'll then be deployed on our Serverless GPU cluster and callable with any of our serverside SDKs:

• Python
• Node JS / Typescript
• Go

You can monitor buildtime and runtime logs by clicking the logs button in the model view on the Banana Dashboard](https://app.banana.dev)

Use Banana for scale.