git404hub

what is swell-event fr?

aaronparton2-sketch/swell-event — explained in plain English

Analysis updated 2026-05-18

39Audience · generalLicense

tl;dr

Swell Event is an n8n workflow template that watches surf forecasts and, when conditions are good, automatically proposes and books a whole surf trip once you approve it in a chat poll.

vibe map

mindmap
  root((swell-event))
    What it does
      Forecast monitoring
      Trip proposal
      Chat approval
    Tech stack
      n8n
      Telegram
      Apify
      Bland AI
    Use cases
      Surf trip automation
      Chat based approval
      Automation template
    Audience
      Surfers
      Automation hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Get automatically notified in a group chat when the surf forecast for your spot turns good for several days straight.

VIBE 2

Have flight and villa options scraped and priced automatically whenever a good swell window appears.

VIBE 3

Approve a trip with one tap and let the workflow handle flight emails, an out of office reply, and a taxi booking.

VIBE 4

Use as a template for building your own n8n automation that reacts to a forecast or condition and proposes a plan.

what's the stack?

n8nTelegramApifyBland AIGmail API

how it stacks up fr

aaronparton2-sketch/swell-eventaa2448208027-code/localaihotswapahxn00/owntv
Stars393939
LanguagePythonKotlin
Setup difficultymoderateeasy
Complexity3/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

in plain english

Swell Event is a single automation workflow built for the n8n workflow tool that watches a surf forecast for one spot and, when conditions turn good for several days in a row, lines up an entire trip proposal for you to approve. The repository is a template you import into your own n8n account and connect to your own accounts and API keys. The workflow checks the Surfline forecast every six hours using a free public lookup, with no login needed. When it detects a few days of strong swell and offshore wind in a row, it scrapes for the cheapest flights and a nearby villa using a paid scraping service called Apify, then puts together one proposal with the dates, swell details, flight price, and villa into a group chat on Telegram as a poll. Only if someone in the chat taps yes does anything move forward. Once approved, flight options get emailed, an out of office reply turns on automatically once the flight lands, live flight tracking triggers a taxi booking through an AI voice calling service called Bland when you land, and a food delivery order through Gojek is placed so drinks are waiting when you arrive at the villa. To use it, you import the workflow file into n8n, then fill in your own Telegram bot token and chat id, an Apify token, a Bland AI key, a Gmail credential for email steps, your n8n instance URL, and the phone number Bland should call. The README stresses setting spend caps on the Apify and Bland services since those cost real money, and states that nothing books an actual flight or trip without a person tapping yes first. The project is released under the MIT license.

prompts (copy fr)

prompt 1
Walk me through importing the swell-event.workflow.json file into my n8n instance and connecting my own credentials.
prompt 2
Help me set spend caps on the Apify scraper nodes in this n8n workflow before running it live.
prompt 3
Explain how the Telegram poll step in this workflow triggers the rest of the booking flow.
prompt 4
Show me how to swap the surf spot used by the Surfline nodes in this n8n workflow for a different location.
peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.