justadam / goml

On-line Machine Learning in Go (and so much more)

goml

Golang Machine Learning, On The Wire

goml (pronounced like the data format 'toml') is a batteries included machine learning library written entirely in Golang. It lets you create models of data stored as float64's, persist them to disk, and predict other values from them. The coolest part, among many cool parts, is that you can train most models in an on-line fashion, learning in a 'reactive' manner while waiting for further data on channels! Most models can also be trained in batch settings, using either stochastic or batch gradient descent!

Each of the packages have individual README's where you can learn about how to use each of the models. Even better than the short summaries in the README is the extensive documentation with examples and descriptions in GoDoc (look at the button above.) You could also look at our comprehensive tests to see error handline and other details, as well as look at the clean, expressive, and modular source code.

Installation

go get github.com/cdipaolo/goml/base

# This could be any other model package if you want
#
# Also, the base package is imported already
# by many of the packages so you might not even
# need to `go get` the package explicitly
go get github.com/cdipaolo/goml/perceptron

Documentation

All the code is well documented, and the source is/should be really readable if you'd like to make sense of it all! Look at each package (like right now, in GitHub,) and you will see a link to Godoc as well as an explanation of the package and an example usage. You can even click on the main bullets below and it'll take you to those packages. Also you could just use the Godoc link at the top of this README and navigate to the package you'd like to see more about.

Sub-bullets below will take you directly to the source code of the model.

Currently Implemented Models

• Generalized Linear Models (all have stochastic GA, batch GA, and online options except for locally weighted linear regression)
  • Ordinary Least Squares
  • Locally Weighted Linear Regression
  • Logistic Regression
  • Softmax (Multiclass Logistic) Regression
• Perceptron only in online options
  • Online, Binary Perceptron
  • Online, Binary Kernel Perceptron
• Clustering
  • K-Means Clustering
    • Both online and batch versions
  • K-Nearest-Neighbors Clustering
    • Can use any distance metric, with L-p Norm, Euclidean Distance, and Manhattan Distance pre-defined within the goml/base package
• Text Classification
  • Multinomial (Multiclass) Text-Based Naive Bayes

Contributing!

see CONTRIBUTING.

I'd love help with any of this if anybody thinks that they would like to implement a model that isn't here, or if they have improvements to current models implemented, or if they want to help with documentation (this would be greatly appreciated, believe me, writing great documentation takes time! 👍)

LICENSE - MIT

see LICENSE