Welcome to the Tangelo Web Framework!

Tangelo is a general-purpose web server framework, built on top of CherryPy. Once it’s set up, it stays out of your way, clearing the path for you to use HTML5, CSS, JavaScript, and other web technologies such as

  • JQuery
  • D3
  • Bootstrap
  • WebGL
  • Canvas
  • Vega

to create rich web applications - from traditional, static pages, to cutting-edge, visual, dynamic displays. Tangelo also lets you include Python scripts as part of your application, alongside your HTML and Javascript files, running them on your behalf to do anything from retrieving a few database results for display, to engaging with powerful computational engines such as Hadoop to compute complex results.

To help in creating these applications, Tangelo exports the Tangelo API, which exists as a collection of Python functions, JavaScript functions, and a set of rules for creating flexible and powerful web services. This document describes all the pieces that fit together to make Tangelo work.

Please visit the Tangelo homepage or the GitHub repository for more information.

Quick Start

  1. Install Git.

  2. Install CMake.

  3. Open a shell and run the following:

    git clone https://github.com/Kitware/tangelo.git
    cd tangelo
    mkdir build
    cd build
    cmake ..
    make
    pip install dist/Tangelo-[version].tar.gz    # May require sudo
    tangelo start
  4. Visit your Tangelo instance at http://localhost:8000.

Quick Start for Windows

Windows machines are “special”. Take these steps to get things going.

  1. Install Git.

  2. Install CMake.

  3. Install Python 2.7 Windows X86-64 installer.

  4. Install Windows Python packages for pip, pymongo, and twisted. Choose the package links ending in amd64-py2.7.exe.

  5. Open the Git Bash shell and run the following:

    git clone https://github.com/Kitware/tangelo.git
    cd tangelo
    mkdir build
    cd build
    curl -OL https://github.com/martine/ninja/releases/download/v1.4.0/ninja-win.zip
    unzip ninja-win.zip
    cmake -G Ninja ..
    ninja
    /c/Python27/Scripts/pip install dist/Tangelo-[version].tar.gz
    /c/Python27/Scripts/tangelo start
  6. Visit your Tangelo instance at http://localhost:8000.

Command Line Utilities

Indices and tables