https://github.com/nimbleboxai/nbox
The official python package for NimbleBox. Exposes all APIs as CLIs and contains modules to make ML 🌸
https://github.com/nimbleboxai/nbox
data-science machine-learning ml-infrastructure ml-platform ml-service mlops mlops-automation mlops-pipeline mlops-tool mlops-workflow model-deployment model-management model-monitoring model-serving practical-mlops
Last synced: 28 days ago
JSON representation
The official python package for NimbleBox. Exposes all APIs as CLIs and contains modules to make ML 🌸
- Host: GitHub
- URL: https://github.com/nimbleboxai/nbox
- Owner: NimbleBoxAI
- License: apache-2.0
- Created: 2021-07-29T11:06:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-10-02T23:51:39.000Z (over 2 years ago)
- Last Synced: 2025-11-29T08:25:00.925Z (about 1 month ago)
- Topics: data-science, machine-learning, ml-infrastructure, ml-platform, ml-service, mlops, mlops-automation, mlops-pipeline, mlops-tool, mlops-workflow, model-deployment, model-management, model-monitoring, model-serving, practical-mlops
- Language: Python
- Homepage: https://nimblebox.ai/docs/nbox/start
- Size: 63.7 MB
- Stars: 86
- Watchers: 4
- Forks: 14
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://pypi.org/project/nbox/)
[](https://pepy.tech/project/nbox)
## 🧐 What is Nbox?
`nbox` provides first class CLI + python package support for all NimbleBox infrastructure and services. You can
```bash
# 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
pip install nbox
```
Next you need to authenticate yourself with the CLI:
```bash
nbx login
```
# Stability and Compatibility
Status: The library is currently undergoing heavy development.
- `nbx projects`:
- `nbx projects - artifacts --help` stable ✅
- `nbx projects - run --help` stable ✅
- `nbx jobs --help`: mostly stable 🟡
- `nbx serve --help`: mostly stable 🟡
# 🤷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
### 🦾 Automate with Ease
### 🚀 Intuitive Dashboard
# 🏁 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
```python
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:
```bash
# 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](https://discord.gg/qYZHxMaCsE) and someone from our community or engineering team will respond!
## 🔖Read our [Blog](https://nimblebox.ai/blog).
# 🧩 License
The code in thist repo is licensed as [Apache License 2.0](./LICENSE). Please check for individual repositories for licenses.