Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Embedded Scripting Language Designed for C++
C++ CMake Other

This branch is 117 commits behind develop

Failed to load latest commit information.
cmake add support for biicode
contrib Don't use scopes around arithmetic operators
include/chaiscript Add 'GLOBAL' keyword #122
samples Reorg of parsing code for maintainability / performance
unittests Merge pull request #175 from totalgee/develop
.decent_ci-Linux.yaml More catch() analysis warning cleanups
.decent_ci-MacOS.yaml Change to TBZ2 for MacOS packages
.decent_ci-Windows.yaml Remove all /analyze from VS12, it's too slow
.decent_ci.yaml Fix results location
.travis.yml Correct travis yaml
CMakeLists.txt Enable thread_local in more cases, ignore clang warnings
biicode.conf Update biicode and get master updated to v5.6.0 Add notes about literal numerics
license.txt Get ready for 5.6.0 release Get ready for 5.6.0 release Add release notes for 5.7.0

Master Status: Build Status Coverage Status

Develop Status: Build Status Coverage Status


(c) 2009-2012 Jonathan Turner (c) 2009-2015 Jason Turner

Release under the BSD license, see "license.txt" for details.



ChaiScript is one of the only embedded scripting language designed from the ground up to directly target C++ and take advantage of modern C++ development techniques, working with the developer like he expects it to work. Being a native C++ application, it has some advantages over existing embedded scripting languages:

  1. It uses a header-only approach, which makes it easy to integrate with existing projects.
  2. It maintains type safety between your C++ application and the user scripts.
  3. It supports a variety of C++ techniques including callbacks, overloaded functions, class methods, and stl containers.


ChaiScript requires a C++11 compiler to build with support for variadic templates. It has been tested with gcc 4.6 and clang 3.1 (with libcxx). MacOS 10.8 (Mountain Lion) is also known to support the C++11 build with Apple's clang 4.0. MSVC 2013 or newer is supports also. For more information see the build dashboard.


  • Add the ChaiScript include directory to your project's header search path
  • Add #include <chaiscript/chaiscript.hpp> to your source file
  • Instantiate the ChaiScript engine in your application. For example, create a new engine with the name chai like so: chaiscript::ChaiScript chai
  • The default behavior is to load the ChaiScript standard library from a loadable module. A second option is to compile the library into your code, see below for an example.

Once instantiated, the engine is ready to start running ChaiScript source. You have two main options for processing ChaiScript source: a line at a time using chai.eval(string) and a file at a time using chai.eval_file(fname)

To make functions in your C++ code visible to scripts, they must be registered with the scripting engine. To do so, call add:

chai.add(chaiscript::fun(&my_function), "my_function_name");

Once registered the function will be visible to scripts as "my_function_name"


ChaiScript is similar to ECMAScript (aka JavaScript(tm)), but with some modifications to make it easier to use. For usage examples see the "samples" directory, and for more in-depth look at the language, the unit tests in the "unittests" directory cover the most ground.

For examples of how to register parts of your C++ application, see "example.cpp" in the "src" directory. Example.cpp is verbose and shows every possible way of working with the library. For further documentation generate the doxygen documentation in the build folder or see the website

The shortest complete example possible follows:

/// main.cpp

#include <chaiscript/chaiscript.hpp>

double function(int i, double j)
  return i * j;

int main()
  chaiscript::ChaiScript chai;
  chai.add(chaiscript::fun(&function), "function");

  double d = chai.eval<double>("function(3, 4.75);");

Or, if you want to compile the std lib into your code, which reduces runtime requirements.

/// main.cpp

#include <chaiscript/chaiscript.hpp>
#include <chaiscript/chaiscript_stdlib.hpp>

double function(int i, double j)
  return i * j;

int main()
  chaiscript::ChaiScript chai(chaiscript::Std_Lib::library());
  chai.add(chaiscript::fun(&function), "function");

  double d = chai.eval<double>("function(3, 4.75);");
Something went wrong with that request. Please try again.