IBM / LNN

A `Neural = Symbolic` framework for sound and complete weighted real-value logic
https://IBM.github.io/LNN/
Apache License 2.0
226 stars 438 forks source link
logic machine-learning neuro-symbolic-ai reasoning

Build Status PRs Welcome License CII Best Practices Code style: black

Logical Neural Networks

LNNs are a novel Neuro = Symbolic framework designed to seamlessly provide key properties of both neural nets (learning) and symbolic logic (knowledge and reasoning).

Quickstart

To install the LNN:

  1. Make sure that the python version you use in line with our setup file, using a fresh environment is always a good idea:
    conda create -n lnn python=3.9 -y
    conda activate lnn
  2. Install the master branch to keep up to date with the latest supported features:
    pip install git+https://github.com/IBM/LNN

Contribution

Contributions to the LNN codebase are welcome!

Please have a look at the contribution guide for more information on how to set up the LNN for contributing and how to follow our development standards.

Documentation

Read the Docs Academic Papers Educational Resources Neuro-Symbolic AI API Overview Python Module
Docs Academic Papers Getting Started Neuro-Symbolic AI API Python Module

Citation

If you use Logical Neural Networks for research, please consider citing the reference paper:

@article{riegel2020logical,
  title={Logical neural networks},
  author={Riegel, Ryan and Gray, Alexander and Luus, Francois and Khan, Naweed and Makondo, Ndivhuwo and Akhalwaya, Ismail Yunus and Qian, Haifeng and Fagin, Ronald and Barahona, Francisco and Sharma, Udit and others},
  journal={arXiv preprint arXiv:2006.13155},
  year={2020}
}