ErgoAI Documentation

Note: ErgoAI is the new name for Ergo Suite.  

Tutorials

  • The ErgoAI Tutorial is a set of lessons that introduces you to the fundamentals of authoring knowledge bases (a.k.a., rulebases) in ErgoAI. It includes  a number of worked examples with sample executable ErgoAI files. The tutorial provides an overview of the ErgoAI system from the very basics to more advanced topics.
  • The Capturing Real World Knowledge in Ergo tutorial illustrates the process of capturing real world knowledge in ErgoAI, with the goal of enabling reasoning and question answering. The initial case study is drawn from the lecture notes of a course on knowledge representation taught at Stanford University in 2011.  The knowledge source is the California Driver’s Handbook and the focus of the reasoning task is on knowledge that can be objectively and operationally used by the driver of a vehicle. Example files and step-by-step instructions for knowledge base creation are included.

 

ErgoAI Manuals

  • Guide to ErgoAI Packages: Covers connectors from Ergo to other non-Ergo information sources and systems such as Java, SQL SPARQL, RDF/OWL, tabular data, XML, JSON, and more.

 

XSB Manuals

These manuals are primarily for use by experienced developers who need low-level features that are accessible directly in XSB.

Release Notes

ErgoAI 2.0 (Myia): Release October 17, 2018 Ergo Suite 1.3  (Zeno) : Released March 1, 2018 Ergo Suite 1.2 (Solon): Release September 25, 2017

Getting Started With ErgoAI

If you are new to ErgoAI, the best place to start is with the FAQ, tutorial and the ErgoAI Studio manual.  A basic knowledge of Prolog is helpful in understanding ErgoAI.  Prolog tutorials and textbooks, for example Learn Prolog Now, can be found online.  As you advance to the next stage, the ErgoAI Reasoner User’s Manual is a complete reference to the system.  The Guide to ErgoAI Packages provides all the details you will need to connect your ErgoAI knowledge base to the outside world.  The ErgoAI Examples Bank provides runnable, annotated examples for a variety of tasks using ErgoAI to augment the examples found in the tutorial.  The ErgoAI and XSB Users Forum is the place to post questions, find answers, share projects, and build collaboration. Finally, the XSB manuals are useful to those who need to supplement their knowledge bases with low-level primitives that an experienced developer might need in some cases.

Forum and FAQ

Ergo and XSB Users Forum: A place for users to post questions and answers, share interesting projects, and discuss ideas about knowledge based systems in general. (Historical Note: Flora-2, mentioned in older forum posts, was a previous fully-open-source subset of Ergo.)

ErgoAI FAQ: Frequently Asked Questions about ErgoAI.

ErgoAI Examples Bank

We created the ErgoAI Example Bank to provide users with runnable, annotated examples that illustrate the various advanced features of Ergo Suite. Each folder contains an ‘About’ document explaining the example as well as the example files themselves with both data and rules.

Examples include:

  • Java and Python integration
  • Defeasible reasoning
  • Connecting ErgoAI to SQL databases
  • RDF and OWL import
  • Querying SPARQL endpoints
  • Importing tabular data
  • Importing XML
  • Working with JSON
  • Doing input and output
  • ErgoText and Federal Regulation W

This is a living document and more categories of examples will be added. Suggestions from users on how to improve the examples or what additional examples would be of interest as well as user-contributed examples are welcome!  Please email us at info@coherentknowledge.com with your thoughts and ideas. The examples could be both of the HOWTO type as well as domain-specific (e.g., e-commerce, e-learning).