The MindsDB JavaScript SDK allows you to unlock the power of machine learning right inside your web applications. We provide interfaces to perform most MindsDB operations, such as training and querying models, and connecting your own datasources to MindsDB.
If you haven't already, make sure to create a MindsDB account to use with the SDK.
npm install --save mindsdb-js-sdk
We have full TypeScript support. Just import the types you need directly. For example:
import { Database, Model, ModelPrediction, Project, Table, View } from 'mindsdb-js-sdk';
Before performing any operations, you must connect to MindsDB. By default, all operations will go through MindsDB Cloud REST APIs, but you can use a self-hosted version of MindsDB as well. In future releases, we will support connecting directly to MySQL instances.
MindsDB Cloud:
import MindsDB from 'mindsdb-js-sdk';
// NOTE: If you're using CommonJS module syntax instead of ES6 imports:
// const MindsDB = require("mindsdb-js-sdk").default;
try {
await MindsDB.connect({
user: 'mindsdbuser@gmail.com',
password: 'mypassword'
});
} catch(error) {
// Failed to authenticate.
}MindsDB Pro:
import MindsDB from 'mindsdb-js-sdk';
try {
await MindsDB.connect({
host: 'http://<YOUR_INSTANCE_IP>',
user: 'mindsdbuser@gmail.com',
password: 'mypassword',
managed: true
});
} catch(error) {
// Failed to authenticate.
}Self-hosted
import MindsDB from 'mindsdb-js-sdk';
try {
// No authentication needed for self-hosting
await MindsDB.connect({
host: 'http://127.0.0.1:47334'
});
} catch(error) {
// Failed to connect to local instance.
}Using your own Axios instance. See src/util/http.ts for the default instance we use.
import MindsDB from 'mindsdb-js-sdk';
import axios from 'axios';
// Use 'host' option in MindsDB.connect to specify base URL override.
const customAxios = axios.create({
timeout: 1000,
});
try {
await MindsDB.connect({
user: mindsdbuser@gmail.com,
password: mypassword,
httpClient: customAxios
});
} catch(error) {
// Failed to authenticate.
}The following code example assumes you already imported and connected to MindsDB.
You can connect to many database integrations through MindsDB. For example, to connect to a Postgres database:
const connectionParams = {
'user': 'postgres',
'port': 15093,
'password': 'password',
'host': '127.0.0.1',
'database': 'postgres'
}
try {
const pgDatabase = await MindsDB.Databases.createDatabase(
'psql_datasource',
'postgres',
connectionParams);
} catch (error) {
// Couldn't connect to database.
}// Can also use MindsDB.Databases.getAllDatabases() to get all databases.
const dbToDelete = await MindsDB.Databases.getDatabase('useless_db');
if (dbToDelete) {
try {
// Can also call MindsDB.Databases.deleteDatabase('useless_db') directly.
await dbToDelete.delete();
} catch (error) {
// Something went wrong while deleting the database.
}
}The following code example assumes you already imported and connected to MindsDB.
When directly using SQL queries, we recommend escaping them when possible using libraries like mysql.
const user = 'raw_unsafe_username'
const query = `SELECT * FROM my_db.customer_data WHERE user=${mysql.escape(user)}`;
try {
const queryResult = await MindsDB.SQL.runQuery(query);
if (queryResult.rows.length > 0) {
const matchingUserRow = queryResult.rows[0];
// Do something with returned data.
// {
// user: 'raw_unsafe_username',
// email: 'useremail@gmail.com',
// other_data: 9001,
// ...
// }
}
} catch (error) {
// Something went wrong sending the API request or executing the query.
}The following code examples assumes you already imported and connected to MindsDB.
const allProjects = await MindsDB.Projects.getAllProjects();
allProjects.forEach(p => {
console.log(p.name);
});The following code example assumes you already imported and connected to MindsDB.
See full training options docs
See full query options docs and full batch query options docs
Simple queries:
const regressionTrainingOptions = {
select: 'SELECT * FROM demo_data.home_rentals',
integration: 'example_db'
};
try {
// MindsDB.Models.retrainModel has the same interface for retraining models.
// The returned promise resolves when the model is created, NOT when training is actually complete.
let homeRentalPriceModel = await MindsDB.Models.trainModel(
'home_rentals_model',
'rental_price',
'mindsdb',
regressionTrainingOptions);
// Wait for the training to be complete. This is just a simple example. There are much better ways to do this.
while (homeRentalPriceModel.status !== 'complete' && homeRentalPriceModel.status !== 'error') {
homeRentalPriceModel = await MindsDB.Models.getModel('home_rentals_model', 'mindsdb');
}
const queryOptions = {
where: [
'sqft = 823',
'location = "good"',
'neighborhood = "downtown"',
'days_on_market = 10'
]
}
const rentalPricePrediction = homeRentalPriceModel.query(queryOptions);
console.log(rentalPricePrediction.value);
console.log(rentalPricePrediction.explain);
console.log(rentalPricePrediction.data);
} catch (error) {
// Something went wrong training or querying.
}A more complex example using batch querying:
const timeSeriesTrainingOptions = {
integration: 'example_db',
select: 'SELECT * FROM demo_data.house_sales',
orderBy: 'saledate',
groupBy: 'bedrooms',
window: 8,
horizon: 4,
using: {
'key': 'value',
'labels': ['house-label', 'test-label'],
'model.args': {
'submodels': [{
'module': 'LightGBM',
'args': {
'stop_after': 12,
'fit_on_dev': true
}
}]
}
}
}
try {
const houseSalesForecastModel = await MindsDB.Models.trainModel(
'house_sales_model',
'rental_price',
'mindsdb',
timeSeriesTrainingOptions);
// Wait for training to be complete...
// See simple query example.
//...
//...
const modelDescription = await houseSalesForecastModel.describe();
console.log(modelDescription);
const queryOptions = {
// Join model to this data source.
join: 'example_db.demo_data.house_sales',
// When using batch queries, the 't' alias is used for the joined data source ('t' is short for training/test).
// The 'm' alias is used for the trained model to be queried.
where: ['t.saledate > LATEST', 't.type = "house"'],
limit: 4
}
const rentalPriceForecasts = await houseSalesForecastModel.batchQuery(queryOptions);
rentalPriceForecasts.forEach(f => {
console.log(f.value);
console.log(f.explain);
console.log(f.data);
})
} catch (error) {
// Something went wrong training or predicting.
}The following code example assumes you already imported and connected to MindsDB.
See full training options docs
Retraining:
const homeRentalPriceModel = await MindsDB.Models.getModel('home_rentals_model', 'mindsdb');
if (homeRentalPriceModel.updateStatus === 'available') {
try {
// Equivalent to SQL 'RETRAIN mindsdb.home_rentals_model'.
// For custom retraining:
// homerentalPriceModel.retrain('example_db', trainingOptions);
// See training options in Training & Querying example for more context.
// Does NOT block on training. The promise resolves after training starts.
await homeRentalPriceModel.retrain();
} catch (error) {
// Something went wrong with retraining.
}
}Adjusting:
const homeRentalPriceModel = await MindsDB.Models.getModel('home_rentals_model', 'mindsdb');
const adjustSelect = 'SELECT * FROM demo_data.home_rentals WHERE days_on_market >= 10';
const params = { 'key' : 'value' }
try {
// Does NOT block on adjusting. The promise resolves after adjusting starts.
await homeRentalPriceModel.adjust(
{ integration: 'example_db', select: adjustSelect, using: params });
} catch (error) {
// Something went wrong adjusting.
}After you create a view, you can query it by including it in SELECT statements as if it's a table.
The following code example assumes you already imported and connected to MindsDB.
const viewSelect = `SELECT t.sqft, t.location, m.rental_price
FROM example_db.home_rentals_data as t
JOIN mindsdb.home_rentals_model as m
`;
try {
const predictionsView = await MindsDB.Views.createView(
'predictions_view',
'mindsdb',
viewSelect);
} catch (error) {
// Something went wrong creating the view.
}Being part of the core MindsDB team is accessible to anyone who is motivated and wants to be part of that journey!
Please see below how to contribute to the project, also refer to the contributing documentation.
- Report a bug
- Improve documentation
- Discuss the code implementation
- Submit a bug fix
- Propose new features
- Test the SDK
In general, we follow the "fork-and-pull" Git workflow.
- Fork the mindsdb-js-sdk repository
- Clone the repository
- Make changes and commit them
- Push your local branch to your fork
- Submit a Pull request so that we can review your changes
- Write a commit message
Please note that this project is released with a Contributor Code of Conduct. By participating in this project, you agree to abide by its terms.
Join our mission of democratizing machine learning!
If you have additional questions or you want to chat with the MindsDB core team, please join our Slack community.
To get updates on MindsDB’s latest announcements, releases, and events, sign up for our Monthly Community Newsletter.