Getting Started

Getting the source

The latest source is hosted at github. To grab the latest release, go here. For the more adventurous, you can get the latest source code here.

Getting Boost

ChaiScript requires Boost (at least 1.34), which you can get here.

Compiling the evaluator

Use cmake to generate a project appropriate for your platform.

In Unix, after configuring the project with cmake, type

make chai

In Windows, open the generated .sln file and build the "chai" target.

If you would prefer to compile by hand:

cd chaiscript
./g++ -Iinclude -I<path to Boost> src/main.cpp -o chaiscript_eval

Using the evaluator

In Windows:

chai.exe
eval>

In Linux and OS X:

./chai
eval>

The evaluator allows you to evaluate ChaiScript expressions. This is a great way to get a feel for the language. You can also pass ChaiScript source files to the evaluator from the commandline to run them as standalone scripts.

Starting an example project

The minimal ChaiScript project requires only a few lines:

#include <chaiscript/chaiscript.hpp>
int main() {
  using namespace chaiscript;
 
  ChaiScript chai;
  chai.eval("print(\"Hello, world\")");
 
  return 0;
}

For more examples, see the official documentation.