/ml5-library

Friendly machine learning for the web! πŸ€–

Primary LanguageJavaScriptMIT LicenseMIT

ml5

All Contributors

BrowserStack StatusVersion Twitter Follow

This project is currently in development.

Friendly machine learning for the web!

ml5.js aims to make machine learning approachable for a broad audience of artists, creative coders, and students. The library provides access to machine learning algorithms and models in the browser, building on top of TensorFlow.js.

The library is supported by code examples, tutorials, and sample data sets with an emphasis on ethical computing. Bias in data, stereotypical harms, and responsible crowdsourcing are part of the documentation around data collection and usage.

ml5.js is heavily inspired by Processing and p5.js.

Usage

There are several ways you can use the ml5.js library:

  • You can use the latest version (0.5.0) by adding it to the head section of your HTML document:

v0.5.0

<script src="https://unpkg.com/ml5@0.5.0/dist/ml5.min.js" type="text/javascript"></script>

  • If you need to use an earlier version for any reason, you can change the version number. The previous versions of ml5 can be found here. You can use those previous versions by replacing <version> with the ml5 version of interest:
<script src="https://unpkg.com/ml5@<version>/dist/ml5.min.js" type="text/javascript"></script>

For example:

<script src="https://unpkg.com/ml5@0.5.0/dist/ml5.min.js" type="text/javascript"></script>
  • You can also reference "latest", but we do not recommend this as your code may break as we update ml5.
<script src="https://unpkg.com/ml5@latest/dist/ml5.min.js" type="text/javascript"></script>

Resources

Standalone Examples

You can find a collection of standalone examples in this repository within the examples/ directory. You can also test working hosted of the examples online on the ml5.js examples index website (TODO: Add a link).

These examples are meant to serve as an introduction to the library and machine learning concepts.

Code of Conduct

We believe in a friendly internet and community as much as we do in building friendly machine learning for the web. Please refer to our CODE OF CONDUCT for our rules for interacting with ml5 as a developer, contributor, or user.

Contributing

Want to be a contributor πŸ— to the ml5.js library? If yes and you're interested to submit new features, fix bugs, or help develop the ml5.js ecosystem, please go to our CONTRIBUTING documentation to get started.

See CONTRIBUTING πŸ› 

Acknowledgements

ml5.js is supported by the time and dedication of open source developers from all over the world. Funding and support is generously provided by a Google Education grant at NYU's ITP/IMA program.

Many thanks BrowserStack for providing testing support.

Contributors

Thanks goes to these wonderful people (emoji key):


Daniel Shiffman

πŸ’» πŸ’‘ πŸ“† πŸ‘€ ⚠️ πŸ“Ή

CristΓ³bal Valenzuela

πŸ’» πŸ’‘ πŸ‘€ πŸ”§ ⚠️

Yining Shi

πŸ’» πŸ’‘ πŸ‘€ πŸ”§ ⚠️ πŸ›

Hannah Davis

πŸ’» πŸ’‘

Joey Lee

πŸ’» πŸ’‘ πŸ‘€ πŸ–‹ ⚠️

AshleyJaneLewis

πŸ“ 🎨 πŸ“‹ πŸ–‹

Ellen Nickles

πŸ“ πŸ–‹ πŸ€” βœ…

Itay Niv

πŸ’» πŸ’‘

Nikita Huggins

πŸ“ πŸ–‹ πŸ€”

Arnab Chakravarty

πŸ–‹ πŸ““

Aidan Nelson

πŸ’» πŸ’‘

WenheLI

πŸ’» πŸ’‘ 🚧 πŸ€”

Darius Kazemi

πŸ€” πŸ’¬

Dingsu Wang

πŸ’» πŸ’‘

garym140

πŸ–‹ πŸ“ πŸ€” πŸ““

Gene Kogan

πŸ’» πŸ’‘ πŸ€”

Hayley Hwang

πŸ’» πŸ’‘ πŸ€”

Lisa Jamhoury

πŸ’‘ πŸ€”

Alejandro Matamala Ortiz

🎨 πŸ–‹ πŸ“

Maya Man

πŸ’» πŸ’‘

Mimi Onuoha

πŸ€” πŸ–‹ πŸ‘€

Yuuno, Hibiki

πŸ’» πŸ’‘ 🚧

Dan Oved

πŸ’» πŸ’‘ πŸ’¬ πŸ€”

Stephanie Koltun

πŸ’» πŸ’‘ πŸ–‹ πŸ“ 🎨

YG Zhang

πŸ’» πŸ’‘ πŸ€”

Wenqi Li

πŸ’» πŸ’‘ πŸš‡

Brent Bailey

⚠️ πŸ’» πŸ’‘

Jonarod

πŸ’»

Jasmine Otto

πŸ’» ⚠️ πŸ’‘

Zaid Alyafeai

πŸ’» πŸ’‘ πŸ€” πŸ’¬

Jacob Foster

πŸ’» πŸ’‘ ⚠️

Memo Akten

πŸ’» πŸ’‘

Mohamed Amine

πŸ’» πŸ’‘ πŸ€” ⚠️

Oliver Wright

πŸ’» ⚠️

Marshal Hayes

πŸ“–

Reiichiro Nakano

πŸ’» ⚠️ πŸ’‘

Nikhil Thorat

πŸ’» πŸ’‘ πŸ€” πŸš‡

Irene Alvarado

πŸ’» πŸ’‘ 🚧 πŸ€”

Andrew Lee

πŸ’» πŸ’‘ πŸ€”

Jerhone

πŸ“–

achimkoh

πŸ’» πŸ’‘ ⚠️

Jim

πŸ’‘ πŸ“– πŸ–‹

Junya Ishihara

🚧 πŸ’»

Naoto HIÉDA

🚧

aarΓ³n montoya-moraga

🚧 πŸ’‘

b2renger

πŸ’» πŸš‡

Aditya Sharma

🚧

okuna291

πŸ€”

Jenna

πŸ€”

nicoleflloyd

πŸ–‹ 🎨 πŸ““

jepster-dk

πŸ’» πŸ€”

Xander Jake de los Santos

πŸ€”

Cassie Tarakajian

πŸ› πŸš‡ πŸ€”

Dave Briccetti

πŸ›

Sblob1

πŸ›

Jared Wilber

πŸ’‘ πŸ€” πŸ’»

danilo

πŸ’» πŸ€”

Emma Goodliffe

πŸ€” πŸ’¬ 🚧

Yang

πŸ’» πŸ›

Lydia Jessup

πŸ’» πŸ€” πŸ’‘

CJ R.

πŸ“– πŸ–‹

Fabio Corona

πŸ›

Tobias Nickel

πŸ› πŸ’»

Michael Salaverry

πŸ–‹ πŸ›

Rob

πŸ› πŸ’¬

Pujaa Rajan

πŸ’‘ πŸ›

Nick McIntyre

⚠️ πŸ›

Andy Baio

πŸ–‹ 🚧

Wenqi Li

πŸ–‹ πŸ’» πŸš‡ 🚧 πŸ€”

garym140

🎨

nicoleflloyd

🎨

Jim

πŸ–‹ 🚧 πŸ€”

Yeswanth

🚧 πŸ›

Pettrus Sherlock

πŸ› 🚧

danilo

πŸ–‹

Andreas Refsgaard

πŸ–‹

Brian Jordan

πŸ–‹

bradley inniss

πŸ–‹

Kaushlendra Pratap

πŸ–‹

maxdevjs

πŸ–‹

josher19

πŸ–‹ πŸ›

Frederik De Bleser

πŸ–‹

Violet

πŸ›

Tirta Wening Rachman

πŸ’» πŸ–‹ πŸ€”

MikΓ‘ Kruschel

πŸ’» πŸ›

Takanobu Asanuma

πŸ–‹

Martin L. Jensen

πŸ–‹

Hugo Romano

πŸ–‹

Darshan Sen

πŸ–‹

Ludwig Stumpp

πŸ‘€ πŸ› πŸ’‘

Bomani Oseni McClendon

πŸ–‹ πŸ’»

Jang Haemin

πŸ–‹

Anton Filatov

πŸ–‹

Elijah Lucian

πŸ“–

Tam

πŸ–‹

RGV

πŸ’¬

hansvana

πŸ–‹

Ali Karpuzoglu

πŸ› 🚧

Jacob Wysko

πŸ–‹

Dilwoar Hussain

πŸ“–

Manaswini Das

πŸ“–

Benjamin Botwin

πŸ‘€ πŸ’¬ πŸ€”

Henrique Mota

πŸ‘€ πŸ’¬ πŸ€”

CaseyPan

πŸ’» πŸ€”

Sam Tarakajian

πŸ’» πŸ› 🚧 πŸ€”

Michael Bell

πŸ“– πŸ› 🚧

machenmusik

πŸ’‘

Pranav Dudhane

πŸ“–

TΓΌndi SzΓ‘sz

🎨 πŸ€”

hellonun

πŸ€” πŸ““

Pierre Grimaud

πŸ“– πŸ–‹

Greg French

πŸ›

Dale Markowitz

πŸ’» πŸ€”

Ragland Asir

πŸ“–

This project follows the all-contributors specification. Contributions of any kind welcome!