MLlib is Apache Spark's scalable machine learning library.

Ease of Use

Usable in Java, Scala and Python.

MLlib fits into Spark's APIs and interoperates with NumPy in Python (starting in Spark 0.9). You can use any Hadoop data source (e.g. HDFS, HBase, or local files), making it easy to plug into Hadoop workflows.

points = spark.textFile("hdfs://...")

model = KMeans.train(points, k=10)
Calling MLlib in Python


High-quality algorithms, 100x faster than MapReduce.

Spark excels at iterative computation, enabling MLlib to run fast. At the same time, we care about algorithmic performance: MLlib contains high-quality algorithms that leverage iteration, and can yield better results than the one-pass approximations sometimes used on MapReduce.

Logistic regression in Hadoop and Spark

Easy to Deploy

Runs on existing Hadoop clusters and data.

If you have a Hadoop 2 cluster, you can run Spark and MLlib without any pre-installation. Otherwise, Spark is easy to run standalone or on EC2 or Mesos. You can read from HDFS, HBase, or any Hadoop data source.


MLlib 1.3 contains the following algorithms:

  • linear SVM and logistic regression
  • classification and regression tree
  • random forest and gradient-boosted trees
  • recommendation via alternating least squares
  • clustering via k-means, Gaussian mixtures, and power iteration clustering
  • topic modeling via latent Dirichlet allocation
  • singular value decomposition
  • linear regression with L1- and L2-regularization
  • isotonic regression
  • multinomial naive Bayes
  • frequent itemset mining via FP-growth
  • basic statistics
  • feature transformations

Refer to the MLlib guide for usage examples.


MLlib is developed as part of the Apache Spark project. It thus gets tested and updated with each Spark release.

If you have questions about the library, ask on the Spark mailing lists.

MLlib is still a young project and welcomes contributions. If you'd like to submit an algorithm to MLlib, read how to contribute to Spark and send us a patch!

Getting Started

To get started with MLlib:

  • Download Spark. MLlib is included as a module.
  • Read the MLlib guide, which includes various usage examples.
  • Learn how to deploy Spark on a cluster if you'd like to run in distributed mode. You can also run locally on a multicore machine without any setup.