Skip to main content

TinyMS is an Easy-to-Use deep learning development toolkit.

Project description

TinyMS logo


PyPI - Python Version PyPI Downloads DockerHub Build Status Documentation Status Releases LICENSE Slack PRs Welcome

English | 查看中文

TinyMS is an Easy-to-Use deep learning framework development toolkit based on MindSpore, designed to provide quick-start guidelines for machine learning beginners.

TinyMS Architecture


Distribution Version Command
PyPI x.y.z pip install tinyms==x.y.z
latest pip install git+
Docker x.y.z docker pull tinyms==x.y.z
latest -

NOTICE: The x.y.z version shown above should be replaced with the real version number.

Please checkout the install document to quickly install or upgrade TinyMS project.

Quick start

Have no idea what to do with TinyMS❓ See the Quick Start to implement the image classification application in one minutes❗

Besides, here are some use cases listed to demonstrate how TinyMS simplifies the code flow for users.

Data loading and preprocess

from import MnistDataset, download_dataset
from import mnist_transform

data_path = download_dataset('mnist')
mnist_ds = MnistDataset(data_path, shuffle=True)
mnist_ds = mnist_transform.apply_ds(mnist_ds)

Network construction

from tinyms.model import lenet5

net = lenet5(class_num=10)

Model train/evaluation

from tinyms.model import Model

model = Model(net)
model.compile(loss_fn=net_loss, optimizer=net_opt, metrics=net_metrics)
model.train(epoch_size, train_dataset)

Model prediction

from PIL import Image
import tinyms as ts
from tinyms.model import Model, lenet5
from import mnist_transform

img =
img = mnist_transform(img)

net = lenet5(class_num=10)
model = Model(net)

input = ts.expand_dims(ts.array(img), 0)
res = model.predict(input).asnumpy()
print("The label is:", mnist_transform.postprocess(res))

API documentation

If you are interested in learning TinyMS API, please find TinyMS Python API in API Documentation.


For a more detailed step-by-step video tutorial, please refer to the following website.

Episode Title Content Docs Status Update Time
EP01 How to learn Deep Learning? The Most Efficient Way For Beginners! Teacher's profile+DeepLearning Course Introduction - Published 2021.3.30
EP02 How we teach computers to understand pictures? Three Ways to Install TinyMS It uncovers the magic of computer vision + three ways to install TinyMS (Ubuntu, Win10, Docker) TinyMS Installation For Beginners Published 2020.3.31
EP03 Learn Shell Script in 30 Minutes It covers the essential concepts such as using variables, basic operators, loops & functions and so on. It also gives you an insight by scaling down some real-time scenarios and demonstrating them using the docker container. Learn Shell Script in 30 Minutes (doc) Published 2020.4.1


For any developers who are not familiar with how TinyMS community works, please find the Contributing Guidelines to get started.

Release Notes

The release notes, see our RELEASE.


Apache License 2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tinyms, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size tinyms-0.2.1-py3-none-any.whl (129.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tinyms-0.2.1.tar.gz (78.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page