huginn/huginn

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

Huginn – Your Self‑Hosted Automation Engine

What it does Huginn lets you run agents that watch the web, listen for events, and act for you. Think of it as a self‑hosted, hackable version of IFTTT/Zapier: each agent creates an event, passes it along a directed graph, and triggers other agents. Because it runs on your own server you keep full control of your data.

Key capabilities

  • Scrape sites, monitor RSS/IMAP/webhooks/MQTT and fire alerts.
  • Weather, travel‑deal, or price‑watch notifications.
  • Detect statistical peaks or gaps in a stream of events.
  • Digest and schedule email summaries.
  • Post to Slack, Telegram, Threads, Twitter, etc., and send SMS/voice via Twilio.
  • Use OpenAI‑compatible APIs for summarisation, translation, image or speech generation.
  • Store files on Dropbox, S3, FTP or the local filesystem.
  • Write custom logic with JavaScript, Liquid templates, or jq.
  • Publish your own JSON or RSS feeds from collected events.
  • Track personal location over time.
  • Connect to any service via webhooks.

How to try it

  • Docker (quick start): docker run -it -p 3000:3000 ghcr.io/huginn/huginn then open http://localhost:3000/ and log in as admin with the password shown in the container logs.
  • Local development: clone the repo, copy .env.example → .env, install MySQL/PostgreSQL, run bundle && npm install, set up the DB with the provided rake commands, then start with bundle exec foreman start.

Running in production

  • Recommended: Docker‑Compose using the official single‑process images (ghcr.io/huginn/huginn-single-process).
  • Works on managed container platforms (Render, Fly.io, Railway, DigitalOcean App Platform) as long as you provide a persistent DB and keep a worker process alive.
  • Community packages exist for YunoHost and Unraid.

Extensibility Agents are Ruby classes; you can add new ones by writing a gem and listing it in the ADDITIONAL_GEMS env var, or contribute directly to the core repo. The project encourages community‑written gems for specialised tasks.

Community & support

  • Discussions, issue tracker, and a “suggest an agent” thread on GitHub.
  • Documentation, tutorials, and a wiki for novice setup and agent creation.
  • Sponsored hosting options listed in doc/sponsors.md.

License MIT – free to use, modify, and self‑host.

Huginn is a genuine open‑source automation platform that fits squarely in the AI/automation space, offering hooks for LLM APIs while primarily focusing on event‑driven workflows.

Related

  • Project
    HKUDS/nanobot

    An ultra-lightweight, self-hosted personal AI agent framework that integrates multiple LLM providers, long-term memory, and various chat apps into a single runtime.

  • Project
    sickn33/agentic-awesome-skills

    A library of over 2,600 installable playbooks that allow AI agents to search, select, and apply reusable instructions for complex technical tasks.

  • Project
    KeygraphHQ/shannon

    Shannon is an open‑source, Docker‑based AI agent that automatically analyzes a web app’s source code, runs live exploits against the running service, and produces exploit‑validated security reports (PDF/Markdown/SARIF). It works with any major LLM provider (Anthropic, OpenAI, xAI, Bedrock, local models), integrates into CI/CD via GitHub Actions/GitLab, and is released under AGPL‑3.0. Commercial Pro/Enterprise editions add black‑box testing, SCA, findings management, and hosted services.

  • Project
    kepano/obsidian-skills

    A collection of agent skills that enable AI agents to Claude Code, Codex, and Open Code to create and edit content within Obsidian vaults using specialized syntax and formats.