Create agents that monitor and act on your behalf. Your agents are standing by!
Huginn is a system for building agents that perform automated tasks for you online. Huginn's Agents create and consume events, propagating them along a directed graph.

renovate[bot] 5ef52980ea Update minor updated gems vor 2 Tagen
.github f318e06725 Delete .github/workflows/close_inactive_issues.yml vor 3 Monaten
.s2i 15c294cc66 Update to OpenShift v3 quickstart templates vor 7 Jahren
app fc421a4581 Disable transparent decompression of the typhoeus adapter vor 3 Wochen
bin d22712a151 fix file.exists? error and update cedar stack since 18 is EOL vor 9 Monaten
config ee3a0e415f Allow the GET method for OmniAuth vor 3 Wochen
data 735e4022c5 Merge branch 'master' of https://github.com/huginn/huginn vor 5 Jahren
db 4518d0e8db Rename the `array` option of WebsiteAgent to `single_array` for clarity vor 1 Monat
deployment 56c0235122 suppress logrotate error vor 1 Jahr
doc 7063e2c274 Update documents vor 4 Wochen
docker 60fb8e8e08 3344 Adds keys for repositories. vor 7 Monaten
lib 85451b6540 Refactor gemfile_helper by using the latest Ruby features vor 7 Monaten
media 4889533fe0 Adding square icon and iOS assets vor 9 Jahren
openshift a30321fd11 Some small changes to update the openshift templates so that they work, including: vor 4 Jahren
public 8ea677607a Regenerate site icon files vor 9 Jahren
script e4ec657537 Use travi-ci's new docker infrastructure + caching vor 10 Jahren
spec c2527e4d2f Upgrade Faraday to v2 vor 4 Wochen
tmp 1201c18c1c ensuring the tmp folder is created in the source tree vor 10 Jahren
vendor 43ec3439cf Update dotenv to 3.1.0 vor 7 Monaten
.buildpacks 3cd3a234b3 Add heroku-buildpack-jq to install jq vor 5 Jahren
.dockerignore 085473263f Remove additional nitrous files (#1791) vor 8 Jahren
.env.example 4d6f910ba6 Change the default SMTP settings vor 6 Monaten
.gitignore 2efdf4cdcb Upgrade to Rails 6 vor 4 Jahren
.irbrc 7b8c1f133c Add a .irbrc vor 1 Jahr
CHANGES.md 4850929147 Update CHANGES.md vor 4 Wochen
Capfile a16fb09fa6 Add capistrano 3 and documentation vor 9 Jahren
Gemfile 5ef52980ea Update minor updated gems vor 2 Tagen
Gemfile.lock 56c119440f Update dependency rails-html-sanitizer to v1.6.1 [SECURITY] (#3474) vor 1 Woche
Guardfile 36ece6cd3b Fix running specs with guard and spring vor 7 Jahren
LICENSE f371431922 Clarify license vor 11 Jahren
Procfile d76ea3dea5 Replace some other occurrences of the references to the old URL vor 7 Jahren
Procfile.CF 0c9c08168c Huginn cloudfoudnry compatible vor 9 Jahren
README.md a1ca83921a Update README.md to revise Heroku paid plan vor 1 Monat
Rakefile 5fbeb105b2 Update gems and configs to Rails5 vor 8 Jahren
VERSION 48a024845a update VERSION, README, and CHANGES vor 11 Jahren
app.json 67e0e7a5d5 #3334 - Updates heroku app.json stack descriptor. vor 11 Monaten
build_docker_image.sh c6b8fe3fc6 Handle file permissions in a cleaner way while building Docker images vor 1 Jahr
config.ru 4410917933 Run bin/rails app:update vor 1 Jahr
manifest.yml.sample 7cbd714ad4 Added comment to manifestfile vor 9 Jahren

README.md

Huginn


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 email 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 email when they change
  • Connect to Adioso, HipChat, FTP, IMAP, Jabber, JIRA, MQTT, nextbus, Pushbullet, Pushover, RSS, Bash, Slack, StubHub, translation APIs, Twilio, Twitter, and Weibo, to name a few.
  • Send digest email 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

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!

Examples

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

Docker

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 https://github.com/huginn/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 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, email messages 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 email 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.

Develop

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.

Deployment

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

Heroku

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 only on a paid subscription plan for Heroku. For non-experimental use, we strongly recommend Heroku's 1GB paid plan or our Docker container.

OpenShift

OpenShift Online

Try Huginn on OpenShift Online

Create a new app with either mysql or postgres:

oc new-app -f https://raw.githubusercontent.com/huginn/huginn/master/openshift/templates/huginn-mysql.json

or

oc new-app -f https://raw.githubusercontent.com/huginn/huginn/master/openshift/templates/huginn-postgresql.json

Note: 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.

The templates should work on a v3 installation or the current v4 online.

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 Weather Data API key from Pirate Weather. Sign up 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.

License

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