The Caliko library is an implementation of the FABRIK inverse kinematics algorithm in Java.
Clone or download
Alastair Lansley Alastair Lansley
Alastair Lansley and Alastair Lansley Fixed minor formatting issue in user guide
Latest commit ced3692 Jun 12, 2018


The Caliko library is an implementation of the FABRIK inverse kinematics (IK) algorithm in the Java programming language, and is released under the MIT software license. See LICENSE.txt for further details.

The FABRIK algorithm is explained in the following research paper: Aristidou, A., & Lasenby, J. (2011). FABRIK: a fast, iterative solver for the inverse kinematics problem. Graphical Models, 73(5), 243-260.

If referencing this project in your research, APA style referencing for the accompaniying research paper is: Lansley, A., Vamplew, P., Smith, P., & Foale, C. (2016). Caliko: An inverse kinematics software library implementation of the FABRIK algorithm. Journal of Open Research Software, 4(1).

You can watch a short video outlining the setup and functionality of the Caliko library here:


The library is a Maven multi-module project with the following modules:

The caliko module contains the core IK portion of the library and is capable of running without any visualisation or external dependencies.

The caliko-visualisation module contains the optional visualisation component of the library which provides the ability to draw various IK structures/chains/bones and depends on the core caliko functionality as well as the LWJGL3 library.

The caliko-demo module contains a demonstration of the library utilising both 2D and 3D IK chains in various configurations. It requires the caliko, caliko-visualisation and LWJGL3 libraries.

Build and Setup

To build yourself:

git clone

mvn clean package or mvn clean install

Alternatively, download a release from:


To use the library in your own Maven project, declare the following dependencies:

  1. If you only need the IK algorithm and do not need any visualisation:
  1. If you need the IK algorithm and the visualisation:

Demo controls

  • Left mouse button sets target in 2D mode and enables mouse-look in 3D mode.
  • Up/Down cursors - Toggle 2D/3D mode.
  • Left/Right cursors - Prev/Next demo.
  • Space - Pause/Resume target movement (3D).
  • L - Toggle display lines.
  • M - Toggle display models (3D).
  • X - Toggle display axes (3D).
  • F - Toggle fixed base mode.
  • P - Toggle perspective / orthographic projection (3D)
  • R - Toggle rotating base locations (3D)
  • Esc - Quit.


High priority

  • Nil.

Medium priority

  • Nil.

Low priority

  • Refactor entire library to use quaternions.
  • Add parabolic constraint types.
  • Streamline Model class object copying.