Skip to content

Latest commit

 

History

History
112 lines (70 loc) · 2.72 KB

README.md

File metadata and controls

112 lines (70 loc) · 2.72 KB
Raw

Build Status

imgflo

imgflo is an image-processing server build on top of GEGL which can be visually programmed using Flowhub.io.

imgflo is pronounced "Imageflo(w)".

Changelog

See ./CHANGES.md

License

MIT

Note: GEGL itself is under LGPLv3.

Deploying to Heroku

Server

Register/log-in with Heroku, and create a new app. First one is free.

Specify the multi buildpack, either at app creation time, in Heroku webui or using

heroku config:set BUILDPACK_URL=https://github.com/ddollar/heroku-buildpack-multi.git

In your git checkout of imgflo, add your Heroku app as a remote.

git remote add heroku git@heroku.com:YOURAPP.git

Deploy, will take ~1 minute

git push heroku

You should now see the imgflo server running at http://YOURAPP.herokuapps.com

Runtime

TODO

Developing and running locally

Note: imgflo has only been tested on GNU/Linux systems. Root is not needed for any of the build.

Pre-requisites

imgflo requires git master of GEGL and BABL, as well as a custom version of libsoup. It is recommended to let make setup this for you, but you can use existing checkouts by customizing PREFIX. You only need to install the dependencies once, or when they have changed, see 'git log -- thirdparty'

git submodule update --init
make dependencies

If you are on an older distribution, you may also need a newer glib version

# make glib # only for older distros, where GEGL fails to build due to too old glib

Install node.js dependencies

npm install

Build

Now you can build & install imgflo itself

make install

To verify that things are working, run the test suite

make check

Register runtime

To actually be able to use it from Flowhub, you need to register the runtime (once).

  • Open Flowhub

  • Login with your Github account

  • Click "Register" under "runtimes" to find your user ID. Copy it and paste in command below

    ./bin/imgflo-register -u USERUUID

In Flowhub, refresh the runtimes and you should see your new "imgflo" instance. Note: sometimes a page refresh is needed.

Run the runtime

Finally, to run the Flowhub.io runtime use. You can customize the port used by setting PORT=3322

make run

You should now be able to create a new project in Flowhub of the "imgflo" type, select your local runtime and create image processing graphs!

Running server

node index.js

You should see your server running at http://localhost:8080