Create agents that monitor and act on your behalf. Your agents are standing by!

Subscribe to updates I use huginn

Statistics on huginn

Number of watchers on Github 18251
Number of open issues 281
Average time to close an issue 2 days
Main language Ruby
Average time to merge a PR 7 days
Open pull requests 36+
Closed pull requests 15+
Last commit 11 months ago
Repo Created almost 6 years ago
Repo Last Updated 10 months ago
Size 7.19 MB
Organization / Authorhuginn
Page Updated
Do you use huginn? Leave a review!
View open issues (281)
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating huginn for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


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 version of IFTTT or Zapier 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.

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.
  • Make sure that you have MySQL or PostgreSQL installed. (On a Mac, the easiest way is with Homebrew. If you're going to use PostgreSQL, you'll need to prepend all commands below with DATABASE_ADAPTER=postgresql.)
  • 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.

Using Huginn Agent gems

Huginn Agents can now be written as external gems and be added to your Huginn installation with the ADDITIONAL_GEMS environment variable. See the Additional Agent gems section of .env.example for more information.

If you'd like to write your own Huginn Agent Gem, please see huginn_agent.

Our general intention is to encourage complex and specific Agents to be written as Gems, while continuing to add new general-purpose Agents to the core Huginn repository.


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


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 launches on the free version of Heroku with significant limitations. For non-experimental use, we strongly recommend Heroku's 1GB paid plan or our Docker container.

OpenShift Online (v3)

Try Huginn on OpenShift Online (v3): oc new-app -f or oc new-app -f You can also use the web console to import either json file by going to Add to Project -> Import YAML/JSON.

If you are on the Starter plan, make sure to follow the guide to remove any existing application.

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.

Huginn was originally created by @cantino in 2013. Since then, many people's dedicated contributions have made it what it is today.

Build Status Coverage Status Dependency Status Bountysource

huginn open issues Ask a question     (View All Issues)
  • over 1 year Agent event flow diagram has lost event counts on upgrade to Ubuntu 16.04
  • over 1 year Add robots.txt to reject spider?
  • over 1 year Login "Remember me" seems invalid under Firefox
  • over 1 year Include media with tweets using Twitter Publish Agent
  • over 1 year Internal server error
  • over 1 year Feature Request: Ability to set global static values
  • over 1 year Manual agent submit disabled after sending event
  • over 1 year Growl agent
  • over 1 year What kind of new Agents should be accepted into Huginn?
  • over 1 year iptable
  • over 1 year Feature request: liquid formatting extensions as gems
  • over 1 year How to debug Job errors? ActiveRecord::ConnectionTime outError
  • over 1 year Shell Command Agent executing commands inside Bundler context
  • over 1 year can't stop jobs
  • over 1 year Cannot run 'bundle'
  • over 1 year Database config for test env missing DATABASE_HOST
  • over 1 year "Run Event propagation" job stuck
  • almost 2 years Suggested agent flow for multiple Reddit subreddit weekly digests
  • almost 2 years entry in log/jobs-1/current '/' is not writable
  • almost 2 years Exception tracking
  • almost 2 years [Proposal] Interactive flow-based scenario/agent configuration
  • almost 2 years Can't install in Ubuntu 16.04 [runit]
huginn open pull requests (View All Pulls)
  • Update OpenShift v2 deployment method
  • Update Ruby version in instructions
  • Fleep agent: post message to conversation
  • Added database creation to
  • Allow ShellCommandAgent to pass custom input params
  • add dropbpx env variable to support app folder
  • Replace therubyracer with mini_racer
  • Alternative way to get Huginn running for demo/development/testing using Vagrant
  • WIP: Docker-ng (alpine)
  • Naive Bayes Agent
  • Make faraday web requests timeout before before DelayedJob max_run_time
  • Encrypt user credentials values
  • Add shared memory to Scenarios & allow JSAgents to manipulate it
  • [WIP] Enhance the Agent picker
  • Telegram charlen fix
  • Reddit agent
  • Added notes to the docs for timezones and env vars
  • Proposal: Allow to access event payload created by previous Agents
  • Fixes #1709 Feature Request: Add HIPCHAT_HOST to Hipchat Agents
  • Allow to run background jobs with Sidekiq
  • Instructions to use SendLocation with the User Location Agent
  • Receive events from "shared" agents created by other users
  • An /agents/all view for admins
  • A ?user= param for admin users to see and edit other users' agents
  • show hover tooltips on the peak graph & set graph minimum to automatic
  • Fix translation agent
  • Trello agents
  • Only show headline if present
  • Allow RSS Agent to create new entries when items update
  • another ascii to utf8 fix
  • add include_retweets option
  • Update the twitter gem and the already retweeted error detection
  • Add ability to publish media on Twitter
  • Fixes my issue #1514 that is a problem where logger was writing as
  • Add Twitter List agent
  • Allow to run on ruby 2.5 and fix warnings
huginn questions on Stackoverflow (View All Questions)
  • 502 bad gateway with manual (recommended) install of huginn with nginx
  • Why won't Huginn agents act on Webfaction?
huginn list of languages used
Other projects in Ruby