Development snapshot

(Snapshot from May 17, 2013, 05:13PM)

All Modules

Download
(includes path planning, machine output and design GUIs)

Design UI

If you don't want to build all of the modules from source, this zip file contains a stand-alone application that runs the kokopelli design interface.

It also includes a set of sample files, some of which might even work.

kokopelli (Mac OS 10.6.8)

Example Files

examples.zip
This zip file contains example .cad files, which use Python scripts to define objects.

Dependencies: Ubuntu 10.04

Python
wxPython
NumPy
PyOpenGL
GCC and G++
libpng
Make
BASH
Okular
Boost (headers, thread, and system library)
cmake

You can install all of the dependencies with the commands
sudo apt-get install python python-wxgtk2.8 python-dev python-pip gcc g++ libpng12-dev make bash okular libboost-thread-dev libboost-system-dev cmake
sudo pip install PyOpenGL PyOpenGL_accelerate numpy

Dependencies: Mac OSX

Experimental Installer

We've recently developed a simple script that walks you through the installation process, including all dependancies.

Open a terminal and paste in the command to begin installation. 

      python <(curl -fsSkL kokompe.cba.mit.edu/install_mac.py)

To interrupt the script at any point, press Control+C

Note: This script assumes that you don't have MacPorts or Fink installed, and installs Homebrew to get dependancies. If you do have MacPorts or Fink, it's probably easier to install dependancies yourself and build from source.

Normal Installation

You will need to install Command Line Tools for XCode, which requires free registration as an Apple Developer.

With this installed, you will need the following packages:

wxpython (Python 2.7 Cocoa version required)
PyOpenGL
Boost
cmake
libpng (for OS X 10.7+)

Homebrew offers a convenient way to install Boost, cmake, and libpng. With Homebrew installed, you can install all three dependancies with the command brew install boost cmake libpng.

Compiling

To compile, after downloading the source above, unzip fab_src.zip and cd to the folder it's in.

Type make fab, which should compile all executables and copy scripts into bin.

At this point, make install will copy all executables and scripts to /usr/local/bin.

Alternatively, you can add the bin folder to your path. To do this, add the line

export PATH=fab/bin:$PATH

to ~/.bashrc, with fab/bin replaced by the location of the bin directory.

Windows (Beta)

Since everything is built with cmake, it is possible to compile the fab modules on Windows. Using Cygwin allows us to build the command-line tools easily, but getting wxPython installed is more challenging.

There's a native wxPython windows installer, but we couldn't figure out how to get it talking to Cygwin. We ended up compiling wxPython in Cygwin, which was a challenge.

If you're interested in maintaining a Windows port, let us know.