Repository files navigation

Train a machine learning model on movement data from the micro:bit'saccelerometer. Run it on your BBC micro:bit, building your own progam that usesthe machine learning model in Microsoft MakeCode.

Try it athttps://createai.microbit.org

This repository is derived fromML-Machine(GitHub), a free andopen-source interactive machine-learning platform from theCenter forComputational Thinking and Design at Aarhus University.

Significant changes have been made to align with the tech stack of otherMicro:bit Educational Foundation applications, add and remove features, andrevise the user experience for some features also in ML-Machine. We encourageyou to review both projects and see which best fits your needs.

Getting up and running:

1. Ensure you have a workingNode.js environment. We recommend using the LTS version of Node.
2. Checkout this repository with Git. GitHub have somelearning resources for Git that you may find useful.
3. Install the dependencies by runningnpm install on the command line in the checkout folder.
4. Choose from the NPM scripts documented below. Trynpm start if you're not sure.

Runs the app in the development mode.

Openhttp://localhost:3000 to view it in the browser.

The page will reload if you make edits.

This does not show TypeScript or lint errors.Use the eslint plugin for your editor and consider also runningnpm run typecheck:watch to see full type checking errors.

Launches thetest runner in interactive mode (unless theCI environment variable is defined).See the section aboutrunning tests for more information.

Builds the app for production to thedist folder.
It correctly bundles React in production mode and optimizes the build for the best performance.

Most users should use the supported Foundation deployment athttps://createai.microbit.org/

The editor is deployed byGitHub actions.

This software is under the MIT open source license.

SPDX-License-Identifier: MIT

Significant code is derived from ML-Machine (also MIT licensed) and is (c)Center for Computational Thinking and Design at Aarhus University andcontributors. See individual file copyright notices for more details.

Conceptually this project draws heavily on the work done by the Center for Computational Thinking and Design at Aarhus University (seeCCTD.dk) and we're hugely grateful for their ongoing support and collaboration.

We use dependencies via the NPM registry as specified by the package.json fileunder common Open Source licenses.

Full details of each package can be found by runninglicense-checker:

$ npx license-checker --direct --summary --production

Omit the flags as desired to obtain more detail.

The repository includes forks of Lancaster's micro:bit-samples repositories formicro:bitV1 andV2. They are MITlicensed.

Trust, partnership, simplicity and passion are our core values we live andbreathe in our daily work life and within our projects. Our open-sourceprojects are no exception. We have an active community which spans the globeand we welcome and encourage participation and contributions to our projectsby everyone. We work to foster a positive, open, inclusive and supportiveenvironment and trust that our community respects the micro:bit code ofconduct. Please see ourcode of conductwhich outlines our expectations for all those that participate in ourcommunity and details on how to report any concerns and what would happenshould breaches occur.