Counting 3,463 Big Data & Machine Learning Frameworks, Toolsets, and Examples...
Suggestion? Feedback? Tweet @stkim1

Last Commit
Jan. 14, 2019
Feb. 12, 2018


NeuroSAT is an experimental SAT solver that is learned using single-bit supervision only. We train it as a classifier to predict satisfiability of random SAT problems and it learns to search for satisfying assignments to explain that bit of supervision. When it guesses sat, we can almost always decode the satisfying assignment it has found from its activations. It can often find solutions to problems that are bigger, harder, and from entirely different domains than those it saw during training.

Specifically, we train it as a classifier to predict satisfiability on random problems that look like this:

When making a prediction about a new problem, it guesses unsat with low confidence (light blue) until it finds a satisfying assignment, at which point it guesses sat with very high confidence (red) and converges:

Iteration →

At convergence, the literal embeddings cluster according to the solution it finds:

We can almost always recover the solution by clustering the literal embeddings, thus making NeuroSAT an end-to-end SAT solver.

At test time it can often find solutions to

  • bigger random problems:

  • graph coloring problems:

  • clique detection problems:

  • dominating set problems:

  • and vertex cover problems:


  • The graph problems are derived from small random graphs (~10 nodes, ~17 edges on average).
  • NeuroSAT is a research prototype and is still vastly less reliable than traditional SAT solvers.


As many readers know too well, facilitating exact reproducibility in machine learning can require a lot of work. NeuroSAT is no exception. We regret that we do not currently provide a push-button way to retrain our exact model on the exact same training data we used in our experiments, though we may provide such functionality in the future depending on the level of interest. For now, we settle for providing our model code, a generator for the distribution of problems we trained on, and enough scaffolding to easily train and test it on small datasets. More utilities will be added in the coming weeks. We hope users will adapt our code to their own infrastructures, improve upon our model, and train it on a greater variety of problems.

Playing with NeuroSAT

The scripts/ directory includes a few scripts to get started.

  1. installs dependencies.
  2. generates toy train and test data.
  3. trains a model for a few iterations on the toy training data.
  4. evaluates the trained model on the toy test data.
  5. tries to solve the toy test problems.
  6. runs,,, and in sequence.

These scripts can be easily modified to train and test on larger datasets.


More information about NeuroSAT can be found in the paper



This work was supported by Future of Life Institute grant 2017-158712.