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.
- 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 large spike.)
- 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.
- Compose digest emails about things you care about to be sent at specific times of 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 arbitrary JavaScript Agents on the server
- Track your location over time
- Create Amazon Mechanical Turk workflows as the inputs, or outputs, of agents. ("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.")
Follow @tectonic for updates as Huginn evolves, and join us in our IRC channel (#huginn on Freenode) to discuss the project.
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.
Really want an issue fixed/feature implemented? Or maybe you just want to solve some community issues and earn some extra coffee money? Then you should take a look at the current bounties on Bountysource.
Have an awesome an idea but not feeling quite up to contributing yet? Head over to our Official 'suggest an agent' thread and tell us about your cool idea!
Please checkout the Huginn Introductory Screencast!
And now, some example screenshots. Below them are instructions to get you started.
If you just want to play around, you can simply fork this repository, then perform the following steps:
- Run
git remote add upstream https://github.com/cantino/huginn.git
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 theAPP_SECRET_TOKEN
variable. - Run
rake db:create
,rake db:migrate
, and thenrake db:seed
to create a development MySQL database with some example Agents. - Run
foreman start
, visit https://localhost:3000/, and login with the username ofadmin
and the password ofpassword
. - Setup some Agents!
- Read the wiki for usage examples and to get started making new Agents.
- Periodically run
git fetch upstream
and thengit checkout master && git merge upstream/master
to merge in the newest version of Huginn.
Note: by default, emails are not sent in the development
Rails environment, which is what you just setup. If you'd like to enable emails when playing with Huginn locally, edit config.action_mailer.perform_deliveries
in config/environments/development.rb
.
If you need more detailed instructions, see the Novice setup guide.
Huginn can run on Heroku for free! Please see the Huginn Wiki for detailed deployment strategies for different providers.
See private development instructions on the wiki.
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.
- Edit
config.ru
, uncomment the DelayedJobWeb section, and change the DelayedJobWeb username and password. - Uncomment
match "/delayed_job" => DelayedJobWeb, :anchor => false
inconfig/routes.rb
. - Uncomment
gem "delayed_job_web"
in Gemfile and runbundle
.
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 has its own IRC channel on freenode: #huginn. Some of us are hanging out there, come and say hello.
Huginn is a work in progress and is just getting started. Please get involved! You can add new Agents, expand the Wiki, or help us simplify and strengthen the Agent API or core application.
Please fork, add specs, and send pull requests!