clojure/core.logic

A logic programming library for Clojure & ClojureScript

Clojure

1,506

1,157 commits

updated Dec 30, 2025

See the code

README

core.logic

A logic programming library for Clojure & ClojureScript. core.logic offers Prolog-like relational programming, constraint logic programming, and nominal logic programming for Clojure. At its heart is an original implementation of miniKanren as described in William Byrd's dissertation Relational Programming in miniKanren: Techniques, Applications, and Implementations as well as the extensions described in cKanren and αKanren. It is designed to be easily extended to forms of logic programming beyond the ones provided.

Releases and dependency information

This project follows the version scheme MAJOR.MINOR.PATCH where each component provides some relative indication of the size of the change, but does not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names).

Latest stable release: 1.1.1

CLI/deps.edn dependency information:

org.clojure/core.logic {:mvn/version "1.1.1"}

Leiningen dependency information:

[org.clojure/core.logic "1.1.1"]

Maven dependency information:

<dependency>
  <groupId>org.clojure</groupId>
  <artifactId>core.logic</artifactId>
  <version>1.1.1</version>
</dependency>

Example usage

(use 'clojure.core.logic)

(run* [q]
  (== q true))  
;;=> (true)

Running the tests

Assuming you have V8 installed from source:

lein cljsbuild once adv
d8 resources/tests.js

If you have another JS engine installed use that instead.

Reasoned Schemer

If you wish to work through The Reasoned Schemer with core.logic make sure to look over this first.

If you're interested in using core.logic from ClojureScript look here.

For more information & documentation please consult the wiki.

Differences from core.unify

core.unify provides a la carte unification facilities that are not deeply tied into the operation of a logic engine. While core.logic does provide a similar simple unifier interface with support for specifying fine-grained constraints, if you have no need for a logic programming system, core.unify may be a better fit.

YourKit

YourKit has given an open source license for their profiler, greatly simplifying the profiling of core.logic performance.

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Developer information

Copyright © David Nolen, Rich Hickey & contributors.

Licensed under the EPL (see the file epl.html).

clojure/core.logic

A logic programming library for Clojure & ClojureScript

Clojure

1,506

1,157 commits

updated Dec 30, 2025

See the code

README

core.logic

A logic programming library for Clojure & ClojureScript. core.logic offers Prolog-like relational programming, constraint logic programming, and nominal logic programming for Clojure. At its heart is an original implementation of miniKanren as described in William Byrd's dissertation Relational Programming in miniKanren: Techniques, Applications, and Implementations as well as the extensions described in cKanren and αKanren. It is designed to be easily extended to forms of logic programming beyond the ones provided.

Releases and dependency information

This project follows the version scheme MAJOR.MINOR.PATCH where each component provides some relative indication of the size of the change, but does not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names).

Latest stable release: 1.1.1

CLI/deps.edn dependency information:

org.clojure/core.logic {:mvn/version "1.1.1"}

Leiningen dependency information:

[org.clojure/core.logic "1.1.1"]

Maven dependency information:

<dependency>
  <groupId>org.clojure</groupId>
  <artifactId>core.logic</artifactId>
  <version>1.1.1</version>
</dependency>

Example usage

(use 'clojure.core.logic)

(run* [q]
  (== q true))  
;;=> (true)

Running the tests

Assuming you have V8 installed from source:

lein cljsbuild once adv
d8 resources/tests.js

If you have another JS engine installed use that instead.

Reasoned Schemer

If you wish to work through The Reasoned Schemer with core.logic make sure to look over this first.

If you're interested in using core.logic from ClojureScript look here.

For more information & documentation please consult the wiki.

Differences from core.unify

core.unify provides a la carte unification facilities that are not deeply tied into the operation of a logic engine. While core.logic does provide a similar simple unifier interface with support for specifying fine-grained constraints, if you have no need for a logic programming system, core.unify may be a better fit.

YourKit

YourKit has given an open source license for their profiler, greatly simplifying the profiling of core.logic performance.

YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.

Developer information

Copyright © David Nolen, Rich Hickey & contributors.

Licensed under the EPL (see the file epl.html).

Project health

Overall

2.8/10

Maintained

0/10

Code review

0/10
OpenSSF Scorecard

Latest release

1.1.1 · Dec 30, 2025

Releases this year

1

Significant stargazers

(top 24 of 31)

Eric Holk

417 followers · starred Apr 2011

favonia

332 followers · starred Aug 2020

Matthew Rocklin

1,883 followers · starred Apr 2011

Max S. New

180 followers · starred Feb 2012