Create agents that monitor and act on your behalf. Your agents are standing by!
Ruby HTML CoffeeScript Shell Other
Latest commit e26c07e Nov 29, 2016 @knu knu Fix a merge conflict
Failed to load latest commit information.
.openshift do not depend on .env.example any more Oct 7, 2014
app Add podcast tags to events emitted by RssAgent Nov 29, 2016
bin Update gems and configs to Rails5 Oct 5, 2016
config Merge pull request #1804 from dsander/cache-agent-type-dropdown Nov 22, 2016
data Use the XPath expression `string(.)` instead of `.//text()` Oct 20, 2016
db Disable automatic URL normalization and absolutization on `url` Nov 27, 2016
deployment Update huginn-ssl Apr 21, 2016
doc Update documentation Oct 9, 2016
docker Fix typos in docker documentation Nov 14, 2016
lib Add podcast tags to events emitted by RssAgent Nov 29, 2016
media Adding square icon and iOS assets May 30, 2015
public Regenerate site icon files Jun 4, 2015
script Use travi-ci's new docker infrastructure + caching Dec 17, 2014
spec Fix a merge conflict Nov 29, 2016
tmp ensuring the tmp folder is created in the source tree Apr 15, 2014
vendor Replace jquery.serializeObject with new implementation Sep 21, 2016
.buildpacks Update .buildpacks Mar 26, 2015
.dockerignore Remove additional nitrous files (#1791) Nov 13, 2016
.env.example Increase default database pool size to 20 (#1805) Nov 20, 2016
.gitignore Remove schema.rb from git Jan 3, 2016
.graphviz Enable Graphviz on Heroku. Aug 9, 2014
.travis.yml Update gems and configs to Rails5 Oct 5, 2016 Normalize URL in `to_uri` and `uri_expand` liquid filters Oct 17, 2016
Capfile Add capistrano 3 and documentation Aug 18, 2015
Gemfile Add podcast tags to events emitted by RssAgent Nov 29, 2016
Gemfile.lock Add podcast tags to events emitted by RssAgent Nov 29, 2016
Guardfile Allow to use spring by setting SPRING in .env Feb 14, 2016
LICENSE Clarify license Mar 17, 2013
Procfile Support 12-factor configurations of dev environments Nov 29, 2015
Procfile.CF Huginn cloudfoudnry compatible Mar 20, 2015 is shutting down (#1789) Nov 13, 2016
Rakefile Update gems and configs to Rails5 Oct 5, 2016
app.json Add logo to app.json Jul 14, 2015 Build docker image on TravisCI Apr 10, 2016 Update gems and configs to Rails5 Oct 5, 2016
manifest.yml.sample Added comment to manifestfile Mar 21, 2015


What is Huginn?

Huginn is a system for building agents that perform automated tasks for you online. They can read the web, watch for events, and take actions on your behalf. Huginn's Agents create and consume events, propagating them along a directed graph. Think of it as a hackable Yahoo! Pipes plus IFTTT on your own server. You always know who has your data. You do.

the origin of the name

Here are some of the things that you can do with Huginn:

  • Track the weather and get an email when it's going to rain (or snow) tomorrow ("Don't forget your umbrella!")
  • List terms that you care about and receive emails when their occurrence on Twitter changes. (For example, want to know when something interesting has happened in the world of Machine Learning? Huginn will watch the term "machine learning" on Twitter and tell you when there is a spike in discussion.)
  • Watch for air travel or shopping deals
  • Follow your project names on Twitter and get updates when people mention them
  • Scrape websites and receive emails when they change
  • Connect to Adioso, HipChat, Basecamp, Growl, FTP, IMAP, Jabber, JIRA, MQTT, nextbus, Pushbullet, Pushover, RSS, Bash, Slack, StubHub, translation APIs, Twilio, Twitter, Wunderground, and Weibo, to name a few.
  • Send digest emails with things that you care about at specific times during the day
  • Track counts of high frequency events and send an SMS within moments when they spike, such as the term "san francisco emergency"
  • Send and receive WebHooks
  • Run custom JavaScript or CoffeeScript functions
  • Track your location over time
  • Create Amazon Mechanical Turk workflows as the inputs, or outputs, of agents (the Amazon Turk Agent is called the "HumanTaskAgent"). For example: "Once a day, ask 5 people for a funny cat photo; send the results to 5 more people to be rated; send the top-rated photo to 5 people for a funny caption; send to 5 final people to rate for funniest caption; finally, post the best captioned photo on my blog."

Gitter Changelog #199

Join us in our Gitter room to discuss the project and follow @tectonic for updates as Huginn evolves.

Join us!

Want to help with Huginn? All contributions are encouraged! You could make UI improvements, add new Agents, write documentation and tutorials, or try tackling issues tagged with #help-wanted. Please fork, add specs, and send pull requests!

Really want a fix or feature? Want to solve some community issues and earn some extra coffee money? Take a look at the current bounties on Bountysource.

Have an awesome idea but not feeling quite up to contributing yet? Head over to our Official 'suggest an agent' thread and tell us!


Please checkout the Huginn Introductory Screencast!

And now, some example screenshots. Below them are instructions to get you started.

Example list of agents

Event flow diagram

Detecting peaks in Twitter

Logging your location over time

Making a new agent

Getting Started


The quickest and easiest way to check out Huginn is to use the official Docker image. Have a look at the documentation.

Local Installation

If you just want to play around, you can simply fork this repository, then perform the following steps:

  • Run git remote add upstream to add the main repository as a remote for your fork.
  • Copy .env.example to .env (cp .env.example .env) and edit .env, at least updating the APP_SECRET_TOKEN variable.
  • Run bundle to install dependencies
  • Run bundle exec rake db:create, bundle exec rake db:migrate, and then bundle exec rake db:seed to create a development database with some example Agents.
  • Run bundle exec foreman start, visit http://localhost:3000/, and login with the username of admin and the password of password.
  • Setup some Agents!
  • Read the wiki for usage examples and to get started making new Agents.
  • Periodically run git fetch upstream and then git checkout master && git merge upstream/master to merge in the newest version of Huginn.

Note: By default, emails are intercepted in the development Rails environment, which is what you just setup. You can view them at http://localhost:3000/letter_opener. If you'd like to send real emails via SMTP when playing with Huginn locally, set SEND_EMAIL_IN_DEVELOPMENT to true in your .env file.

If you need more detailed instructions, see the Novice setup guide.


All agents have specs! And there's also acceptance tests that simulate running Huginn in a headless browser.

  • Install PhantomJS 2.1.1 or greater:
  • Run all specs with bundle exec rspec
  • Run a specific spec with bundle exec rspec path/to/specific/test_spec.rb.
  • Read more about rspec for rails here.



Try Huginn on Heroku: Deploy (Takes a few minutes to setup. Read the documentation while you are waiting and be sure to click 'View it' after launch!)

Huginn works on the free version of Heroku with significant limitations. For non-experimental use, we strongly recommend Heroku's cheapest paid plan or our Docker container.

Please see the Huginn Wiki for detailed deployment strategies for different providers.

Manual installation on any server

Have a look at the installation guide.

Optional Setup

Setup for private development

See private development instructions on the wiki.

Enable the WeatherAgent

In order to use the WeatherAgent you need an API key with Wunderground. Signup for one and then change the value of api_key: your-key in your seeded WeatherAgent.

Disable SSL

We assume your deployment will run over SSL. This is a very good idea! However, if you wish to turn this off, you'll probably need to edit config/initializers/devise.rb and modify the line containing config.rememberable_options = { :secure => true }. You will also need to edit config/environments/production.rb and modify the value of config.force_ssl.


Huginn is provided under the MIT License.

Build Status Coverage Status Dependency Status Bountysource