GitHub

🧐 What is Nbox?

nbox provides first class API support for all NimbleBox.ai infrastructure (NBX-Build, Jobs, Deploy) and services (NBX-Workspaces) components. Write jobs using nbox.Operators

Installation

# on macos find the correct wheel file based on python version: https://github.com/pietrodn/grpcio-mac-arm-build/releases/tag/1.51.1
pip install <wheel_url>
pip install nbox

# on linux
pip install nbox

🤷Why NimbleBox

Write and execute code in Python
Document your code that supports mathematical equations
Create/Upload/Share notebooks
Import notebooks from your local machine
Import/Publish notebooks from/to GitHub
Import external datasets (e.g. from Kaggle)
Integrate PyTorch, TensorFlow, Keras, OpenCV
Share your projects
Collaborate with your team

🚀 Startup Program

If you're a new startup with(<$1M raised,<3 years since founded) then you're in luck to be the part of our startup program!

Get $420k worth of deals on your favorite tools

Check it out !

🎚 Features

🏗️ Freedom To Build

Build Landing Page (2)

🦾 Automate with Ease

Jobs Landing Page

🚀 Intuitive Dashboard

Deploy Landing Page

🏁 Get Started

Install the package from pypi:

When loading nbox for the first time, it will prompt you the username and password and create a secrets file at ~/.nbx/secrets.json. This file then contains all the information that you don’t have to fetch manually again.

APIs

Our APIs are deep, user functions are kept to minimum and most relavant. This documentation contains the full spec of everything, but here’s all the APIs you need to know:

nbox
├── Model          # Framework agnostic Model
│   ├── __call__
│   ├── deploy
│   ├── train_on_instance (WIP)
│   └── train_on_jobs (WIP)
├── Operators      # How jobs are combinations of operators
│   ├── __call__
│   └── deploy
├── Jobs           # For controlling all your jobs
│   ├── logs       # stream logs right on your terminal
│   └── trigger    # manually trigger a job
└── Instance
   ├── __call__    # Run any command on the instance
   └── mv (WIP)    # Move files to and from NBX-Build

Deploy and run any model

Let's take this script as an example

from nbox import operator, Operator
from nbox.lib.shell import ShellCommand

# define your function and wrap it as an operator
@operator()
def foo(x: Dict):
  return "bar"

# or use OO to deploy an API
@operator()
class Baz():
  def __init__(self, power: int = 2):
    # load any model that you want
    self.model = load_tf_pt_model()
    self.power = power
  
  def forward(self, x: float = 1.0):
    return {"pred": x ** self.power}

Through your CLI:

# to deploy a job
nbx jobs upload file:foo 'my_first_job'

# to deploy an API
nbx serve upload file:Baz 'my_first_api'

🛟 How to get help?

Join our discord and someone from our community or engineering team will respond!

🔖Read our Blog.

🧩 License

The code in thist repo is licensed as Apache License 2.0. Please check for individual repositories for licenses.

Release files for nbox 0.12.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nbox 0.12.4
File	Size	Uploaded
nbox-0.12.4.tar.gz	207.5 kB	Apr 4, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for nbox 0.12.4
File	Interpreter	ABI	Platform	Reset
nbox-0.12.4-py3-none-any.whl 214.3 kB Apr 4, 2023	Python 3	none	any	Details

Total release size: 421.8 kB

Release files / nbox-0.12.4.tar.gz

Download URL	nbox-0.12.4.tar.gz
Size	207.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`beff5246ded98574833fb91723f8c2fa254b7f26550fd9d0a367813a51f600e1`
BLAKE2b-256 checksum How to use checksums	`aa34df89c7c14d227d6c71968bb3551712304766b2f4bd9e1b0fbcf71c6b50e4`
Upload date	Apr 4, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.2.2 CPython/3.10.8 Darwin/22.1.0`

Release files / nbox-0.12.4-py3-none-any.whl

Download URL	nbox-0.12.4-py3-none-any.whl
Size	214.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e8901dc0ff48bc53567502cf7be37a73b66d58652d36f91b94cebf066195bf45`
BLAKE2b-256 checksum How to use checksums	`75bf7a759b20b0f7c559c615ebaff5b9a2569bea00e2ba519169eb12f9f42fbf`
Upload date	Apr 4, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.2.2 CPython/3.10.8 Darwin/22.1.0`