MindsDB's goal is to make it very simple for developers to use the power of artificial neural networks in their projects.
Project description
MindsDB is an Explainable AutoML framework for developers built on top of Pytorch. It enables you to build, train and test state of the art ML models in as simple as one line of code.
Try it out
- Installing MindsDB
- Learning from Examples
- MindsDB Explainability GUI
- Frequently Asked Questions
- Provide Feedback to Improve MindsDB
Installation
- Desktop: You can use MindsDB on your own computer in under a minute, if you already have a python environment setup, just run the following command:
pip install mindsdb_native --user
Note: Python 64 bit version is required. Depending on your environment, you might have to use
pip3
instead ofpip
in the above command.*
If for some reason this fail, don't worry, simply follow the complete installation instructions which will lead you through a more thorough procedure which should fix most issues.
- Docker: If you would like to run it all in a container simply:
sh -c "$(curl -sSL https://raw.githubusercontent.com/mindsdb/mindsdb/master/distributions/docker/build-docker.sh)"
Usage
Once you have MindsDB installed, you can use it as follows:
Import MindsDB:
from mindsdb_native import Predictor
One line of code to train a model:
# tell mindsDB what we want to learn and from what data
Predictor(name='home_rentals_price').learn(
to_predict='rental_price', # the column we want to learn to predict given all the data in the file
from_data="https://s3.eu-west-2.amazonaws.com/mindsdb-example-data/home_rentals.csv" # the path to the file where we can learn from, (note: can be url)
)
One line of code to use the model:
# use the model to make predictions
result = Predictor(name='home_rentals_price').predict(when_data={'number_of_rooms': 2, 'initial_price': 2000, 'number_of_bathrooms':1, 'sqft': 1190})
# you can now print the results
print('The predicted price is between ${price} with {conf} confidence'.format(price=result[0].explanation['rental_price']['confidence_interval'], conf=result[0].explanation['rental_price']['confidence']))
Visit the documentation to learn more
Video Tutorial
Please click on the image below to load the tutorial:
(Note: Please manually set it to 720p or greater to have the text appear clearly)
MindsDB Graphical User Interface
You can also work with mindsdb via its graphical user interface (download here). Please click on the image below to load the tutorial:
MindsDB Lightwood: Machine Learning Lego Blocks
Under the hood of mindsdb there is lightwood, a Pytorch based framework that breaks down machine learning problems into smaller blocks that can be glued together seamlessly. More info about MindsDB lightwood's on GITHUB.
Contributing
In order to make changes to mindsdb, the ideal approach is to fork the repository than clone the fork locally PYTHONPATH
.
For example: export PYTHONPATH=$PYTHONPATH:/home/my_username/mindsdb
.
Too test your changes you can run unit tests (fast) and CI tests (slightly longer) locally.
To run unit tests:
- Install pytest:
pip install -r requirements_test.txt
- Run:
pytest
Once you have specific changes you want to merge into master, feel free to make a PR.
Report Issues
Please help us by reporting any issues you may have while using MindsDB.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file mindsdb_native-2.13.0.tar.gz
.
File metadata
- Download URL: mindsdb_native-2.13.0.tar.gz
- Upload date:
- Size: 65.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.7.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 255fae8ecb90e43c187666130bf87fadc03e67b30cc8b67b45987eaa74363f65 |
|
MD5 | 0e83c53ac3fac59851e4e60a22cbd2bc |
|
BLAKE2b-256 | 9ec0e793ca62b70afe5e65337bbc718342428d2aaff3a32c9a34b812472481c0 |