Metadata-Version: 2.1
Name: MindsDB
Version: 24.3.4.2
Summary: MindsDB's AI SQL Server enables developers to build AI tools that need access to real-time data to perform their tasks
Home-page: https://github.com/mindsdb/mindsdb
Download-URL: https://pypi.org/project/mindsdb/
Author: MindsDB Inc
Author-email: jorge@mindsdb.com
License: ELv2
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8,<3.11
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: grpc
Provides-Extra: test
Provides-Extra: all_extras
Provides-Extra: access
Provides-Extra: aerospike
Provides-Extra: altibase
Provides-Extra: anomaly_detection
Provides-Extra: anthropic
Provides-Extra: anyscale_endpoints
Provides-Extra: apache_doris
Provides-Extra: aurora
Provides-Extra: autogluon
Provides-Extra: autokeras
Provides-Extra: autosklearn
Provides-Extra: bigquery
Provides-Extra: binance
Provides-Extra: byom
Provides-Extra: cassandra
Provides-Extra: chromadb
Provides-Extra: ckan
Provides-Extra: clickhouse
Provides-Extra: cloud_spanner
Provides-Extra: cloud_sql
Provides-Extra: cockroach
Provides-Extra: cohere
Provides-Extra: coinbase
Provides-Extra: confluence
Provides-Extra: couchbase
Provides-Extra: crate
Provides-Extra: d0lt
Provides-Extra: databend
Provides-Extra: databricks
Provides-Extra: datastax
Provides-Extra: db2
Provides-Extra: derby
Provides-Extra: discord
Provides-Extra: documentdb
Provides-Extra: dremio
Provides-Extra: druid
Provides-Extra: edgelessdb
Provides-Extra: elasticsearch
Provides-Extra: email
Provides-Extra: empress
Provides-Extra: eventbrite
Provides-Extra: faunadb
Provides-Extra: file
Provides-Extra: firebird
Provides-Extra: flaml
Provides-Extra: frappe
Provides-Extra: github
Provides-Extra: gitlab
Provides-Extra: gmail
Provides-Extra: google_analytics
Provides-Extra: google_books
Provides-Extra: google_calendar
Provides-Extra: google_content_shopping
Provides-Extra: google_fit
Provides-Extra: google_gemini
Provides-Extra: google_search
Provides-Extra: hana
Provides-Extra: hive
Provides-Extra: hsqldb
Provides-Extra: hubspot
Provides-Extra: huggingface_api
Provides-Extra: huggingface
Provides-Extra: huggingface-cpu
Provides-Extra: ignite
Provides-Extra: impala
Provides-Extra: influxdb
Provides-Extra: informix
Provides-Extra: ingres
Provides-Extra: jira
Provides-Extra: kinetica
Provides-Extra: lancedb
Provides-Extra: langchain_embedding
Provides-Extra: langchain
Provides-Extra: leonardoai
Provides-Extra: libsql
Provides-Extra: lightfm
Provides-Extra: lightwood
Provides-Extra: lindorm
Provides-Extra: litellm
Provides-Extra: llama_index
Provides-Extra: ludwig
Provides-Extra: luma
Provides-Extra: mariadb
Provides-Extra: materialize
Provides-Extra: matrixone
Provides-Extra: maxdb
Provides-Extra: mediawiki
Provides-Extra: mendeley
Provides-Extra: merlion
Provides-Extra: milvus
Provides-Extra: mlflow
Provides-Extra: monetdb
Provides-Extra: mongodb
Provides-Extra: monkeylearn
Provides-Extra: ms_teams
Provides-Extra: mssql
Provides-Extra: mysql
Provides-Extra: neuralforecast
Provides-Extra: neuralforecast-extra
Provides-Extra: newsapi
Provides-Extra: notion
Provides-Extra: nuo_jdbc
Provides-Extra: oceanbase
Provides-Extra: openai
Provides-Extra: openbb
Provides-Extra: opengauss
Provides-Extra: openstreetmap
Provides-Extra: oracle
Provides-Extra: orioledb
Provides-Extra: palm
Provides-Extra: paypal
Provides-Extra: pgvector
Provides-Extra: phoenix
Provides-Extra: pinecone
Provides-Extra: pinot
Provides-Extra: plaid
Provides-Extra: planetscale
Provides-Extra: popularity_recommender
Provides-Extra: pycaret
Provides-Extra: qdrant
Provides-Extra: questdb
Provides-Extra: quickbooks
Provides-Extra: rag
Provides-Extra: reddit
Provides-Extra: redshift
Provides-Extra: replicate
Provides-Extra: rocket_chat
Provides-Extra: rockset
Provides-Extra: scylla
Provides-Extra: sendinblue
Provides-Extra: sentence_transformers
Provides-Extra: shopify
Provides-Extra: singlestore
Provides-Extra: slack
Provides-Extra: snowflake
Provides-Extra: solace
Provides-Extra: solr
Provides-Extra: spacy
Provides-Extra: sqlany
Provides-Extra: sqreamdb
Provides-Extra: stabilityai
Provides-Extra: starrocks
Provides-Extra: statsforecast
Provides-Extra: statsforecast-extra
Provides-Extra: strava
Provides-Extra: stripe
Provides-Extra: supabase
Provides-Extra: surrealdb
Provides-Extra: symbl
Provides-Extra: tdengine
Provides-Extra: teradata
Provides-Extra: tidb
Provides-Extra: timegpt
Provides-Extra: timescaledb
Provides-Extra: tpot
Provides-Extra: trino
Provides-Extra: twelve_labs
Provides-Extra: twilio
Provides-Extra: twitter
Provides-Extra: vertex
Provides-Extra: vertica
Provides-Extra: vitess
Provides-Extra: weaviate
Provides-Extra: web
Provides-Extra: webz
Provides-Extra: whatsapp
Provides-Extra: writer
Provides-Extra: xata
Provides-Extra: youtube
Provides-Extra: yugabyte
Provides-Extra: all_handlers_extras
License-File: LICENSE

<h1 align="center">
	<img width="300" src="https://github.com/mindsdb/mindsdb_native/blob/stable/assets/MindsDBColorPurp@3x.png?raw=true" alt="MindsDB">
	<br>
</h1>

<div align="center">



<p>
	<a href="https://github.com/mindsdb/mindsdb/actions"><img src="https://github.com/mindsdb/mindsdb/actions/workflows/release.yml/badge.svg" alt="MindsDB Release"></a>
	<a href="https://www.python.org/downloads/" target="_blank"><img src="https://img.shields.io/badge/python-3.8.x%7C%203.9.x%7C%203.10.x%7C%203.11.x-brightgreen.svg" alt="Python supported"></a>
	<a href="https://pypi.org/project/MindsDB/" target="_blank"><img src="https://badge.fury.io/py/MindsDB.svg" alt="PyPi Version"></a>
	<br />
	<img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/Mindsdb">  <a href="https://hub.docker.com/u/mindsdb" target="_blank"><img src="https://img.shields.io/docker/pulls/mindsdb/mindsdb" alt="Docker pulls"></a>
	<a href="https://ossrank.com/p/630"><img src="https://shields.io/endpoint?url=https://ossrank.com/shield/630"></a>
	<a href="https://www.mindsdb.com/"><img src="https://img.shields.io/website?url=https%3A%2F%2Fwww.mindsdb.com%2F" alt="MindsDB Website"></a>
	<a href="https://mindsdb.com/joincommunity" target="_blank"><img src="https://img.shields.io/badge/slack-@mindsdbcommunity-brightgreen.svg?logo=slack " alt="MindsDB Community"></a>
	<br />
	
</p>

<h3 align="center">
	<a href="https://www.mindsdb.com?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo">Website</a>
	<span> | </span>
	<a href="https://docs.mindsdb.com?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo">Docs</a>
	<span> | </span>
	<a href="https://mindsdb.com/joincommunity">Community Slack</a>
	<span> | </span>
	<a href="https://github.com/mindsdb/mindsdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22">Contribute</a>
 	<span> | </span>
	<a href="https://github.com/mindsdb/mindsdb/discussions/8817"> 20K🌟🎉 </a>
</h3>

</div>

----------------------------------------
[MindsDB](https://mindsdb.com?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo) is the platform for customizing AI from enterprise data. You can create, serve, and fine-tune models in real-time from your database, vector store, and application data.
 [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=The%platform%20for%customizing%20AI,%20from%20enterprise%20data&url=https://github.com/mindsdb/mindsdb&via=mindsdb&hashtags=ai,opensource)

We believe AI will help every company thrive, but off-the-shelf, generic AI usually doesn’t completely meet their needs. With MindsDB’s nearly 200 integrations, any developer can create AI customized for their purpose, faster and more securely. Their AI systems will constantly improve themselves — using companies’ own data, in real-time.

MindsDB "enhances" SQL syntax with AI capabilities to make it accessible for developers worldwide:


| 🎯  Solutions                 | ⚙️ SQL Query Examples |
|---------------------------|-----------|
| 🤖 [Fine-Tuning](https://docs.mindsdb.com/sql/api/finetune#example-3-openai-model)            |  <code> FINETUNE mindsdb.hf_model FROM postgresql.table; </code>  |
| 📚 [Knowledge Base](https://docs.mindsdb.com/agents/knowledge-bases)         | <code> CREATE KNOWLEDGE_BASE my_knowledge FROM (SELECT contents FROM drive.files); </code> |
| 🔍 [Semantic Search](https://docs.mindsdb.com/integrations/ai-engines/rag)        |  <code> SELECT * FROM rag_model WHERE question='What product is best for treating a cold?';  </code>   |
| ⏱️ [Real-Time Forecasting](https://docs.mindsdb.com/sql/tutorials/eeg-forecasting) | <code> SELECT * FROM binance.trade_data WHERE symbol = 'BTCUSDT'; </code> |
| 🕵️ [Agents](https://docs.mindsdb.com/agents/agent)                | <code> CREATE AGENT my_agent USING model='chatbot_agent', skills = ['knowledge_base']; </code>    |
| 💬 [Chatbots](https://docs.mindsdb.com/agents/chatbot)               |  <code> CREATE CHATBOT slack_bot USING database='slack',agent='customer_support'; </code>|
| ⏲️ [Time Driven Automation](https://docs.mindsdb.com/sql/create/jobs)      |  <code> CREATE JOB twitter_bot ( <sql_query1>, <sql_query2> ) START '2023-04-01 00:00:00';   </code>           |
| 🔔 [Event Driven Automation](https://docs.mindsdb.com/sql/create/trigger)      | <code> CREATE TRIGGER data_updated ON mysql.customers_data (sql_code)           |

## ⚡️ Quick Example

Enrich datastores by passing new data through an AI-model and writing results back in the database, this can be solved in a few lines of AI-SQL.  Here is a reference architecture:
<img src='https://docs.google.com/drawings/d/e/2PACX-1vTlROMTlXiYUecoAogwjBVI0eQDYWWI-aY5npcxVjfLzGL6Fs2-YN-aOcUeWFCDzZDxveYe5Dxwilia/pub?w=1438&h=703'></img>


Let's look at automating shopify orders analysis:

```sql
---This query creates a job in MindsDB to analyze Shopify orders.
---It predicts customer engagement scores based on recent completed orders
---and inserts these insights into a customer_engagement table.
---The job runs every minute, providing ongoing updates to the engagement scores.

CREATE JOB mindsdb.shopify_customer_engagement_job AS (

   -- Insert into a table insights about customer engagement based on recent Shopify orders
   INSERT INTO shopify_insights.customer_engagement (customer_id, predicted_engagement_score)
      SELECT
         o.customer_id AS customer_id,
         r.predicted_engagement_score AS predicted_engagement_score
      FROM shopify_data.orders o
      JOIN mindsdb.customer_engagement_model r
         WHERE
            o.order_date > LAST
         AND o.status = 'completed'
      LIMIT 100
)
EVERY minute;

```

## ⚙️ Installation <a name="Installation"></a>

To install locally or on-premise, pull the latest [Docker image](https://hub.docker.com/r/mindsdb/mindsdb/tags?page=1&ordering=last_updated):

```
docker pull mindsdb/mindsdb
```

or, use [pip](https://pypi.org/project/MindsDB/):

```
pip install mindsdb
```

[Read more about Installation](https://docs.mindsdb.com/setup/self-hosted/docker)



## 🔗 Data Integrations <a name="DatabaseIntegrations"></a>

MindsDB allows querying hundreds of data sources, such as databases (both relational and non-relational), data warehouses, streams, and SaaS application data, using standard SQL. This capability stems from MindsDB’s unique ability to translate SQL into real-time data requests. You can find the list of all supported integrations [here](https://docs.mindsdb.com/data-integrations/all-data-integrations).


[:question: :wave: Missing integration?](https://github.com/mindsdb/mindsdb/issues/new?assignees=&labels=&template=feature-mindsdb-request.yaml)


## 📖 Documentation <a name="Documentation"></a>

You can find the complete documentation of MindsDB at [docs.mindsdb.com](https://docs.mindsdb.com?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo).

## 🤍 Support <a name="Support"></a>

If you found a bug, please submit an [issue on GitHub](https://github.com/mindsdb/mindsdb/issues/new/choose).

To get community support, you can:

* Post a question at MindsDB [Slack community](https://mindsdb.com/joincommunity).
* Ask for help at our [GitHub Discussions](https://github.com/mindsdb/mindsdb/discussions).
* Ask a question at [Stackoverflow](https://stackoverflow.com/questions/tagged/mindsdb) with a MindsDB tag.

If you need commercial support, please [contact](https://mindsdb.com/contact/?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo) MindsDB team.

## 🤝 Contributing <a name="Contributing"></a>

A great place to start contributing to MindsDB is to check our GitHub projects :checkered_flag:

* Community contributor's [dashboard tasks](https://github.com/mindsdb/mindsdb/projects/8).
* [First timers only issues](https://github.com/mindsdb/mindsdb/issues?q=is%3Aissue+is%3Aopen+label%3Afirst-timers-only), if this is your first time contributing to an open source project.

We are always open to suggestions, so feel free to open new issues with your ideas, and we can guide you!

Being part of the core team is accessible to anyone who is motivated and wants to be part of that journey!
If you'd like to contribute to the project, refer to the [contributing documentation](https://docs.mindsdb.com/contribute/?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo).

This project is released with a [Contributor Code of Conduct](https://github.com/mindsdb/mindsdb/blob/stable/CODE_OF_CONDUCT.md). By participating in this project, you agree to follow its terms.

Also, check out the [rewards and community programs](https://mindsdb.com/community?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo).


### 💚 Current contributors <a name="Current contributors"></a>

<a href="https://github.com/mindsdb/mindsdb/graphs/contributors">
  <img src="https://contributors-img.web.app/image?repo=mindsdb/mindsdb" />
</a>

Made with [contributors-img](https://contributors-img.web.app).

## 🔔 Subscribe to updates

Join our [Slack community](https://mindsdb.com/joincommunity) and subscribe to the monthly [Developer Newsletter](https://mindsdb.com/newsletter/?utm_medium=community&utm_source=github&utm_campaign=mindsdb%20repo) to get product updates, information about MindsDB events and contests, and useful content, like tutorials.


## ⚖️ License <a name="License"></a>

For detailed licensing information, please refer to the [LICENSE file](https://github.com/mindsdb/mindsdb/blob/master/LICENSE)
