NACE.jl

An implementation of Non-Axiomatic Causal Explorer in Julia

TODO

• Make experiment no. 2 run.
  • hypothesize and other unimplemented functions need to reflect the original logic flow diagram. Multiple functionalities condensed in the current functions need to be split out into those functions.
    • hypothesize
    • prediction_errors
    • new_hypotheses
    • verify_hypothesis
    • max_truth_exp
    • best_hypothesis
    • highest_reward
    • weakest_hypothesis
    • oldest_observed
• Remove old code (everything currently outside NACE.jl), preserving useful parts.
• Lastly, refactor NACE.jl into multiple files to have a clean library structure.

Install

I recommend using Poetry to make a Python virtual env. Spawn the env's shell and run the REPL with julia --project, before installing deps make sure to execute ENV["PYTHON"] = Sys.which("python") -- that will set PyCall to use your env.

In the REPL invoke ] instantiate to install Julia deps.

Run

In the REPL, using NACE should be enough, some things maybe not exported (the API is not yet stable, needless to say) -- those you have to access under the packages namespace (NACE).

There are experiment files that you can run with julia --project experiments/.jl`.

Under the hood, environments are provided by the Farama Foundation's Minigrid library, which relies on the Gymnasium package, also maintained by the Foundation.