Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
An Open Source Implementation of the Actor Model in C++
C++ TeX CMake R Shell Makefile
Failed to load latest commit information.
benchmarks @ 78c7462 Update submodule references
cash @ 340475d Update submodule references
cmake Store CMake config in new header, close #270
examples Fix exception handling in announce_1
libcaf_core Add unit test for latest patch from ufownl
libcaf_io Remove all function that are deprecated since 0.10
libcaf_opencl @ 8a76d29 Update libcaf_opencl reference
libcaf_riac @ ad014ee Simplify extend syntax for typed actors
libcaf_test Fix compiler warnings on GCC and Clang
manual Update PDF manual
nexus @ 1dc99e8 Update submodule references
scripts Fix version name in obs-commit-version.sh
.clang-format Reformatted according to new coding style
.cppcheck-suppressions Fix build on MSVC
.gitignore Store CMake config in new header, close #270
.gitmodules Use HTTPS URL for all submodules
CMakeLists.txt Fix CMake setup for non-ASIO bulids
CONTRIBUTING.md Reformatted according to new coding style
Doxyfile.in Use version from CMake for Doxygen and manual
LICENSE Fix typo in LICENSE
LICENSE_ALTERNATIVE Fix typo in LICENSE
README.md Add Coverity badge to README.md
biicode.conf Add biicode URL to config
configure Add `set_middleman`, remote separate ASIO lib
ignore.bii Add biicode build support

README.md

CAF: C++ Actor Framework

CAF is an open source C++11 actor model implementation featuring lightweight & fast actor implementations, pattern matching for messages, network transparent messaging, and more.

Gitter Jenkins Coverity In Progress Fixed in Develop

On the Web

Get CAF

Linux Packages

We provide binary packages for several Linux distributions using the openSUSE Build Service. Please follow the linked installation guides below or alternatively visit our OBS project homepage: https://build.opensuse.org/package/show/devel:libraries:caf/caf

package description link
caf binaries only stable nightly
caf-devel binaries and headers stable nightly

FreeBSD Ports

We maintain a port for CAF, which you can install as follows:

pkg install caf

Alternatively, you can go to /usr/ports/devel/caf and tweak a few configuration options before installing the port:

make config
make install clean

Homebrew

You can install the latest stable release with:

brew install caf

Alternatively, you can use the development branch by using:

brew install caf --HEAD

Biicode

The official CAF channel is published under caf_bot/actor-framework and includes the following blocks:

  • libcaf_core
  • libcaf_io
  • libcaf_riac
  • libcaf_opencl (depends on OpenCL which is not distributed as part of CAF)

NOTE: You do not need to have CAF installed on your machine. Biicode will automatically do that for you during the build process. Visit this the bii guide for more information.

To use actor-framework in your project, reference the header file as: #include "caf_bot/actor-framework/libcaf_core/caf/all.hpp". Then run bii find to resolve and download the files and bii build to compile your code.

To avoid specifying the block name in your includes add the following to your bii.conf file to allow Biicode to associate all #include "caf/*.hpp" with the actor-framework block:

[includes]
  caf/riac/*.hpp : caf_bot/actor-framework/libcaf_riac
  caf/opencl/*.hpp : caf_bot/actor-framework/libcaf_opencl
  caf/io/*.hpp : caf_bot/actor-framework/libcaf_io
  caf/*.hpp : caf_bot/actor-framework/libcaf_core

Get the Sources

Build CAF from Source

The easiest way to build CAF is to use the configure script. Other available options are using CMake directly or SNocs.

Using the configure Script

The script is a convenient frontend for CMake. See configure -h for a list of available options or read the online documentation.

./configure
make
make test
make install [as root, optional]

Using CMake

All available CMake variables are available online. CAF also can be included as CMake submodule or added as dependency to other CMake-based projects using the file cmake/FindCAF.cmake.

Using SNocs

A SNocs workspace is provided by GitHub user osblinnikov and documented online.

Dependencies

  • CMake
  • Pthread (until C++11 compilers support the new thread_local keyword)

Supported Compilers

  • GCC >= 4.8
  • Clang >= 3.2

Supported Operating Systems

  • Linux
  • Mac OS X
  • FreeBSD 10
  • Note for MS Windows: CAF relies on C++11 features such as variadic templates and unrestricted unions. We will support Visual Studio as soon as Microsoft's compiler implements all required C++11 features. In the meantime, you can use CAF via MinGW.

Scientific Use

If you use CAF in a scientific context, please use the following citation:

@inproceedings{chs-ccafs-14,
  author = {Dominik Charousset and Raphael Hiesgen and Thomas C. Schmidt},
  title = {{CAF - The C++ Actor Framework for Scalable and Resource-efficient Applications}},
  booktitle = {Proc. of the 5th ACM SIGPLAN Conf. on Systems, Programming, and Applications (SPLASH '14), Workshop AGERE!},
  month = {Oct.},
  year = {2014},
  publisher = {ACM},
  address = {New York, NY, USA},
  location = {Portland, OR},
}

You will find the paper online at http://dx.doi.org/10.1145/2687357.2687363

Something went wrong with that request. Please try again.