{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/huginn",
  "slug": "huginn",
  "name": "Huginn",
  "tagline": "Agent system that watches the web and acts on events you define, for example by sending alerts.",
  "replaces": {
    "summary": "Paid workflow automation services, such as Zapier.",
    "products": [
      {
        "slug": "zapier",
        "name": "Zapier",
        "vendor": "Zapier",
        "url": "https://openlogs.fyi/alternatives/zapier"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Ruby"
    },
    {
      "kind": "database",
      "name": "MySQL"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "MIT",
    "class": "osi",
    "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "4 services (2 database or broker: mysql), 0 volume mounts, 1 env value to set, no elevated host access. Heuristic score 5 of 11: medium. A source checkout is needed, so the rating is at least medium."
  },
  "repository": {
    "owner": "huginn",
    "name": "huginn",
    "url": "https://github.com/huginn/huginn"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "docker/single-process/docker-compose.yml",
    "source_repo": "huginn/huginn",
    "source_commit_sha": "74581b082883cd9aa894db7c5671fa7fda6c579f",
    "source_kind": "app_repo",
    "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/docker-compose.yml"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin and git",
      "body": "A host with Docker, the Docker Compose plugin and git. This entry needs a checkout of the project repository.",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "shell",
      "language": "bash",
      "label": "Get the source at commit 74581b0",
      "body": "git init huginn\ncd huginn\ngit remote add origin https://github.com/huginn/huginn.git\ngit sparse-checkout init --cone\ngit sparse-checkout set docker/single-process\ngit fetch --depth 1 --filter=blob:none origin 74581b082883cd9aa894db7c5671fa7fda6c579f\ngit checkout FETCH_HEAD",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 3,
      "kind": "shell",
      "language": "bash",
      "label": "Go to the folder the docs use",
      "body": "cd docker/single-process",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "compose",
      "language": "yaml",
      "label": "The compose file in the checkout: docker/single-process/docker-compose.yml (shown here for reading)",
      "body": "version: '2'\n\nservices:\n  mysqldata:\n    image: mysql:8.4\n    command: /bin/true\n\n  mysql:\n    image: mysql:8.4\n    restart: always\n    env_file:\n      - ../mysql.env\n    volumes_from:\n      - mysqldata\n\n  web:\n    image: ghcr.io/huginn/huginn-single-process\n    restart: always\n    ports:\n      - \"3000:3000\"\n    # Uncomment to run the bundled Smokescreen egress proxy and route all\n    # outbound HTTP(S) requests through it, so that Agents cannot reach\n    # private or link-local addresses.  See doc/manual/outbound-requests.md.\n    # environment:\n    #   - ENABLE_SMOKESCREEN=true\n    env_file:\n      - ../mysql.env\n    depends_on:\n      - mysql\n\n  threaded:\n    image: ghcr.io/huginn/huginn-single-process\n    command: /scripts/init bin/threaded.rb\n    restart: always\n    # Uncomment to run the bundled Smokescreen egress proxy and route all\n    # outbound HTTP(S) requests through it, so that Agents cannot reach\n    # private or link-local addresses.  See doc/manual/outbound-requests.md.\n    # environment:\n    #   - ENABLE_SMOKESCREEN=true\n    env_file:\n      - ../mysql.env\n    depends_on:\n      - mysql\n      - web\n",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/docker-compose.yml",
      "validation_status": "config_ok"
    },
    {
      "order": 5,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "The compose file check ran in a checkout of huginn/huginn at 74581b082883cd9aa894db7c5671fa7fda6c579f (a sparse checkout: the top-level files and the folder docker/single-process), in the folder docker/single-process. The Docker guide for the single-process image tells the reader to run docker-compose up -d in the docker/single-process folder.",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 6,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 7,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:3000. The compose file publishes host port 3000 for the web service.",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/docker-compose.yml",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: web: ghcr.io/huginn/huginn-single-process (no tag), threaded: ghcr.io/huginn/huginn-single-process (no tag). A later pull can get a different version.",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/docker-compose.yml",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file publishes host ports",
      "body": "Host ports: 3000 (web). A port without a host address listens on all host network interfaces.",
      "source_url": "https://github.com/huginn/huginn/blob/74581b082883cd9aa894db7c5671fa7fda6c579f/docker/single-process/docker-compose.yml",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 50090,
    "forks": 4313,
    "open_issues": 703,
    "last_push": "2026-10-18",
    "days_since_push": 4,
    "latest_release": "v2026.10.14",
    "latest_release_date": "2026-10-13",
    "days_since_release": 9
  },
  "links": {
    "html": "https://openlogs.fyi/tools/huginn",
    "markdown": "https://openlogs.fyi/tools/huginn.md",
    "json": "https://openlogs.fyi/tools/huginn.json"
  },
  "updated_at": "2026-10-22"
}