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.
Andrew Cantino 487f35449e Fix translation agent | 8 年 前 | |
---|---|---|
.openshift | 10 年 前 | |
app | 8 年 前 | |
bin | 8 年 前 | |
config | 8 年 前 | |
data | 8 年 前 | |
db | 8 年 前 | |
deployment | 8 年 前 | |
doc | 8 年 前 | |
docker | 8 年 前 | |
lib | 8 年 前 | |
media | 9 年 前 | |
public | 9 年 前 | |
script | 10 年 前 | |
spec | 8 年 前 | |
tmp | 10 年 前 | |
vendor | 9 年 前 | |
.buildpacks | 9 年 前 | |
.dockerignore | 8 年 前 | |
.env.example | 8 年 前 | |
.gitignore | 9 年 前 | |
.graphviz | 10 年 前 | |
.travis.yml | 8 年 前 | |
CHANGES.md | 8 年 前 | |
Capfile | 9 年 前 | |
Gemfile | 8 年 前 | |
Gemfile.lock | 8 年 前 | |
Guardfile | 8 年 前 | |
LICENSE | 11 年 前 | |
Procfile | 9 年 前 | |
Procfile.CF | 9 年 前 | |
README.md | 8 年 前 | |
Rakefile | 11 年 前 | |
VERSION | 11 年 前 | |
app.json | 9 年 前 | |
build_docker_image.sh | 8 年 前 | |
config.ru | 10 年 前 | |
manifest.yml.sample | 9 年 前 | |
nitrous-post-create.sh | 8 年 前 | |
nitrous.json | 8 年 前 |
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.
Join us in our Gitter room to discuss the project and follow @tectonic for updates as Huginn evolves.
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.
The quickest and easiest way to check out Huginn is to use the official Docker image. Have a look at the documentation.
If you just want to play around, you can simply fork this repository, then perform the following steps:
git remote add upstream https://github.com/cantino/huginn.git
to add the main repository as a remote for your fork..env.example
to .env
(cp .env.example .env
) and edit .env
, at least updating the APP_SECRET_TOKEN
variable.bundle
to install dependenciesbundle exec rake db:create
, bundle exec rake db:migrate
, and then bundle exec rake db:seed
to create a development MySQL database with some example Agents.bundle exec foreman start
, visit http://localhost:3000/, and login with the username of admin
and the password of password
.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.
You can quickly create a free development environment for this Huginn project in the cloud on www.nitrous.io:
In the IDE, start Huginn via Run > Start Huginn
and access your site via Preview > 3000
.
All agents have specs! And there's also acceptance tests that simulate running Huginn in a headless browser.
npm install phantomjs
brew install phantomjs
bundle exec rspec
bundle exec rspec path/to/specific/test_spec.rb
.Try Huginn on Heroku: (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.
Have a look at the installation guide.
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.
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.