Wallets and wallet-enabled social protocols unlock many identity improvements for users & developers alike.

<h2>Email</h2>Most websites require your email address for creating an account. Email-based authentication allow the website to 1) contact you and 2) uniquely identify you. Email does a good job at enabling contact - you can retrieve forgotten passwords just as easily as you can email your Grandmother - but it does a pretty poor job at identifying you. Given your email address, there&apos;s no understanding nor context about you, the user. Because of this, companies like Clearbit have built large businesses around enriching email addresses with data sourced from around the web, to make them more useful as identities.<h2>OAuth</h2>This lack of context &amp; understanding is in contrast to other common mechanisms of identifying users, such as OAuth. Login with Google, Twitter or Facebook are a few examples of OAuth-based logins that go beyond just an identity - they let 3rd party developers tap into the closed data these companies have (for better or for worse).<img src="https://storage.googleapis.com/papyrus_images/0e58b7ceb3356adde117f7073340b474.jpg" blurDataURL="data:image/jpeg;base64,/9j/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCAAEAAIDASIAAhEBAxEB/8QAFQABAQAAAAAAAAAAAAAAAAAAAAb/xAAdEAACAgIDAQAAAAAAAAAAAAABAgMEAAUGESFh/8QAFQEBAQAAAAAAAAAAAAAAAAAAAQL/xAAUEQEAAAAAAAAAAAAAAAAAAAAA/9oADAMBAAIRAxEAPwCwt6fQ0rc1WLjejaOB2iVnpqWIU9An75jGMoP/2Q==" width="344" float="none" class="image-node img-center embed">This helps identifiers moves beyond just an identifier, and toward becoming a user, with interests, friends, contacts, followers, profile pictures, genders, birthdates, and more.This is powerful. As a developer, supporting “Login with [social platform]” lets you tap into this enriched data for numerous things:<ul><li>Bootstrap network effects (eg prompting users to subscribe to all their Twitter followers immediately after registration)</li><li>Provide mechanisms of virality (eg automatically crosspost content they create to Facebook)</li><li>Provide better onboarding (eg pre-populating user accounts with avatars, interests and more)</li></ul>There are several downsides to this method of OAuth based authentication, for both developers building atop these platforms and for users that authenticate with them: <ul><li>Platforms can change the rules. Developers are constrained by what platforms allow. Google and Facebook are not <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://nakamoto.com/credible-neutrality/">credibly neutral</a> open protocols - they&apos;re closed platforms with everchanging functionality. There have been <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://geoawesomeness.com/developers-up-in-arms-over-google-maps-api-insane-price-hike/">many</a> different <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://www.theregister.com/2012/08/17/twitter_api_rules/">instances</a> in the past where platforms changed the rules and crippled developers building atop of them.</li><li>Developers get an incomplete picture. A user&apos;s audience is commonly split across multiple platforms. OAuth&apos;ing with Facebook isn’t very beneficial to myself or the developer&apos;s app if 90% of my social graph exists on Twitter. It&apos;s unrealistic for developers to request or expect users to manually link with every single social platform to get a full picture.</li><li>User&apos;s can&apos;t exit with interoperability. If I decide I want to exit Twitter after the Elon Musk acquisition, it’s not possible to export my Twitter followers and use it elsewhere. Even worse - if Twitter decides to ban me, that’s it: there’s no way 3rd party developers building atop Twitter can make use of this data anymore. </li></ul><h2>Wallets</h2>Using cryptowallets alongside crypto-enabled social protocols are an alternative that I believe will bridge the gap between an identity and a user and improve upon the aforementioned issues:<ul><li>They are credibly neutral. Building atop <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://www.varunsrinivasan.com/2022/01/11/sufficient-decentralization-for-social-networks">sufficiently decentralized</a> protocols, not platforms, guarantee that the underlying functionality won&apos;t change after I, as a developer, built a sustainable business.</li><li>It&apos;s easier to get a full picture of a user&apos;s social graph. As a developer, I can permissionlessly ingest the full social graphs of all web3 social platforms, just given a user&apos;s wallet address with no intervention from the user needed. If a user has never used Farcaster but is active on Lens, no problem -- I can still programmatically ingest both to get the complete picture.</li><li>Users can exit with interoperability. If users dislike (or are banned from) a specific client built atop a certain social graph, they can move to another client and continue interacting with the followerbase they&apos;ve built at the protocol-level. Similarly, developers can continue making use of all the underlying data.</li></ul>Though, crypto wallets are not without downsides. Adoption is currently low - everyone has an email but not everyone has a crypto wallet. Additionally, emails allow for easy message exchange but wallets currently do not (though many protocols are trying to fix this), so it&apos;s challenging to reach users strictly by their wallets. Lastly, privacy controls are non-existent: if I didn’t want to share a list of my on-chain followers with a certain platform, there’s no current method of preventing this (in contrast to the granular, user-controlled permissions that OAuth uses).At <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://paragraph.xyz">Paragraph</a>, we&apos;ve built <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://paragraph.xyz/@blog/discovery">several integrations</a> involving wallets-as-an-identity and it’s been a very positive experience. For example, when a user connects their wallet and signs in, we detect if they have a Faracaster account. If so, we permissionlessly pull in their avatar, name, &amp; users they’re following, and bootstrap their Paragraph account by prompting them to subscribe to their followers. No gatekeeping, no OAuth, no action needed from the user - nothing beyond just a wallet address &amp; credibly neutral social protocols.Collect this post as an NFT:<div data-type="highlightEmbed" nftId="63c2e9fe3de4fce815d46692" imgUrl="https://highlight-creator-assets.highlight.xyz/main/image/6a0fc1e1-f184-4f58-9cd4-1301bcea3fea">
 <img src="https://highlight-creator-assets.highlight.xyz/main/image/6a0fc1e1-f184-4f58-9cd4-1301bcea3fea" 
 style="
 width: 100;
 margin-left: auto;
 margin-right; auto;
 "
 />
 <div style="text-align: center;">
 <a style="
 display: inline-block;
 border-radius: 4px;
 margin-top: 4px;
 background-color: rgb(59, 130, 246);
 padding: 16px 24px;
 font-weight: 600;
 line-height: 100%;
 color: rgb(255, 255, 255);
 text-decoration: none;
 "
 href="https://mint.highlight.xyz/63c2e9fe3de4fce815d46692">
 Collect NFT
 </a>
 </div></div>

Email
Most websites require your email address for creating an account. Email-based authentication allow the website to 1) contact you and 2) uniquely identify you. 
Email does a good job at enabling contact - you can retrieve forgotten passwords just as easily as you can email your Grandmother - but it does a pretty poor job at identifying you. Given your email address, there's no understanding nor context about you, the user. Because of this, companies like Clearbit have built large businesses around enriching email addresses with data sourced from around the web, to make them more useful as identities.
OAuth
This lack of context & understanding is in contrast to other common mechanisms of identifying users, such as OAuth. Login with Google, Twitter or Facebook are a few examples of OAuth-based logins that go beyond just an identity - they let 3rd party developers tap into the closed data these companies have (for better or for worse).

This helps identifiers moves beyond just an identifier, and toward becoming a user, with interests, friends, contacts, followers, profile pictures, genders, birthdates, and more.
This is powerful. As a developer, supporting “Login with [social platform]” lets you tap into this enriched data for numerous things:

Bootstrap network effects (eg prompting users to subscribe to all their Twitter followers immediately after registration)

Provide mechanisms of virality (eg automatically crosspost content they create to Facebook)

Provide better onboarding (eg pre-populating user accounts with avatars, interests and more)

There are several downsides to this method of OAuth based authentication, for both developers building atop these platforms and for users that authenticate with them: 

Platforms can change the rules. Developers are constrained by what platforms allow. Google and Facebook are not credibly neutral open protocols - they're closed platforms with everchanging functionality. There have been many different instances in the past where platforms changed the rules and crippled developers building atop of them.

Developers get an incomplete picture. A user's audience is commonly split across multiple platforms. OAuth'ing with Facebook isn’t very beneficial to myself or the developer's app if 90% of my social graph exists on Twitter. It's unrealistic for developers to request or expect users to manually link with every single social platform to get a full picture.

User's can't exit with interoperability. If I decide I want to exit Twitter after the Elon Musk acquisition, it’s not possible to export my Twitter followers and use it elsewhere. Even worse - if Twitter decides to ban me, that’s it: there’s no way 3rd party developers building atop Twitter can make use of this data anymore. 

Wallets
Using cryptowallets alongside crypto-enabled social protocols are an alternative that I believe will bridge the gap between an identity and a user and improve upon the aforementioned issues:

They are credibly neutral. Building atop sufficiently decentralized protocols, not platforms, guarantee that the underlying functionality won't change after I, as a developer, built a sustainable business.

It's easier to get a full picture of a user's social graph. As a developer, I can permissionlessly ingest the full social graphs of all web3 social platforms, just given a user's wallet address with no intervention from the user needed. If a user has never used Farcaster but is active on Lens, no problem -- I can still programmatically ingest both to get the complete picture.

Users can exit with interoperability. If users dislike (or are banned from) a specific client built atop a certain social graph, they can move to another client and continue interacting with the followerbase they've built at the protocol-level. Similarly, developers can continue making use of all the underlying data.

Though, crypto wallets are not without downsides. Adoption is currently low - everyone has an email but not everyone has a crypto wallet. Additionally, emails allow for easy message exchange but wallets currently do not (though many protocols are trying to fix this), so it's challenging to reach users strictly by their wallets. Lastly, privacy controls are non-existent: if I didn’t want to share a list of my on-chain followers with a certain platform, there’s no current method of preventing this (in contrast to the granular, user-controlled permissions that OAuth uses).
At Paragraph, we've built several integrations involving wallets-as-an-identity and it’s been a very positive experience. For example, when a user connects their wallet and signs in, we detect if they have a Faracaster account. If so, we permissionlessly pull in their avatar, name, & users they’re following, and bootstrap their Paragraph account by prompting them to subscribe to their followers. No gatekeeping, no OAuth, no action needed from the user - nothing beyond just a wallet address & credibly neutral social protocols.
Collect this post as an NFT:

Wallets instead of emails for identity

Throughout any given day, my mood &amp; state of mind fluctuates depending on many factors: quality of sleep, what I ate that day, how my personal relationships are sgoing, how my company is doing, etc.Because of this, I try to avoid a fixed schedule as much as possible. I view my day as fluid: I ha...

Throughout any given day, my mood &amp; state of mind fluctuates depending on many factors: quality of sleep, what I ate that day, how my personal relationships are sgoing, how my company is doing, etc.Because of this, I try to avoid a fixed schedule as much as possible. I view my day as fluid: I have a collection of different states of mind throughout the day, and I have a collection of work items that need to be done, so I try to match these up.When I&apos;m feeling creative, I write code or do frontend design. When I&apos;m feeling insightful, I think about longer-term company strategy. When I&apos;m feeling extroverted, I focus on user outreach and customer conversations. Mapping my states of mind to the appropriate deliverable lends itself to my best work. The opposite is also true - forcing tasks in an improper state of mind often produces worse results.This is a simplified view - it certainly won&apos;t be possible in all jobs or on all days - but I&apos;m fortunate enough right now that I&apos;m able to abide by this as much as possible, given that an early-stage startup has time spent mainly between building and talking to users (and both of these have a spectrum of sub-tasks that tap into different states of mind). This is in contrast to my time spent at Google, where I often had days filled with back-to-back meetings.Deliberately not working is also important. If I&apos;m feeling awful and particularly unproductive, I prefer to make a conscious decision to step away and rest, in contrast to making little progress on something while beating myself up over the lack of productivity.

Throughout any given day, my mood & state of mind fluctuates depending on many factors: quality of sleep, what I ate that day, how my personal relationships are sgoing, how my company is doing, etc.
Because of this, I try to avoid a fixed schedule as much as possible. I view my day as fluid: I have a collection of different states of mind throughout the day, and I have a collection of work items that need to be done, so I try to match these up.
When I'm feeling creative, I write code or do frontend design. When I'm feeling insightful, I think about longer-term company strategy. When I'm feeling extroverted, I focus on user outreach and customer conversations. Mapping my states of mind to the appropriate deliverable lends itself to my best work. The opposite is also true - forcing tasks in an improper state of mind often produces worse results.
This is a simplified view - it certainly won't be possible in all jobs or on all days - but I'm fortunate enough right now that I'm able to abide by this as much as possible, given that an early-stage startup has time spent mainly between building and talking to users (and both of these have a spectrum of sub-tasks that tap into different states of mind). This is in contrast to my time spent at Google, where I often had days filled with back-to-back meetings.
Deliberately not working is also important. If I'm feeling awful and particularly unproductive, I prefer to make a conscious decision to step away and rest, in contrast to making little progress on something while beating myself up over the lack of productivity.

Throughout any given day, my mood & state of mind fluctuates depending on many factors: quality of sleep, what I ate that day, how my personal relationships are sgoing, how my company is doing, etc.Because of this, I try to avoid a fixed schedule as much as possible. I view my day as fluid: I ha...

Spending time deliberately

Learn how to create an automated personal assistant with Huginn, and deploy it for free on GCP using Docker.

Paragraph is a blazing-fast, privacy-first, no-frills-attached blogging &amp; newsletter platform. <a target="_blank" rel="noopener noreferrer nofollow" href="https://paragraph.xyz?utm_source=papyrus&amp;utm_medium=colin_blogpost&amp;utm_campaign=huginn_blogpost">Sign up</a> and start writing posts just like this one.<hr>Productivity &amp; automation tools can be powerful. I was delighted to come across a recent <a target="_blank" rel="noopener noreferrer nofollow" href="https://news.ycombinator.com/item?id=21772610">thread on Hacker News</a> discussing a supercharged automation tool: <a target="_blank" rel="noopener noreferrer nofollow" href="https://github.com/huginn/huginn">Huginn</a>. This open-source software performs automated tasks by using &apos;agents&apos; to watch for &apos;events&apos;, and triggering &apos;actions&apos; based on these events.For example, if there&apos;s a sudden spike in discussion on Twitter with the terms &quot;San Francisco Earthquake&quot;, Huginn can send a text to my phone. Or, if a time-sensitive flight deal is posted on one of the many deal-finding websites out there, Huginn can send me an email with the price and a link to Google Flights.Compared to other popular automation tools (IFTTT, Zapier), Huginn has the following benefits:<ul><li>Self-hosted &amp; completely private</li><li>Powerful data processing: write your own JS or use shell scripts</li><li>Liquid templating</li></ul>I wanted to go beyond just automation and introduce some organization - I wanted all notifications to be cataloged &amp; delivered in a centralized way. A personal Slack workspace seemed like the perfect solution for this - I can have a <code>#flights</code> channel for flight deals, or a <code>#trending</code> channel for the, er, pending San Francisco emergencies.I also wanted all of this to be free. Huginn has pretty lax runtime resource requirements (even able to run on a <a target="_blank" rel="noopener noreferrer nofollow" href="https://github.com/huginn/huginn/wiki/Running-Huginn-on-minimal-systems-with-low-RAM-&amp;-CPU-e.g.-Raspberry-Pi">Raspberry Pi</a>, with some tweaking), so a free GCP micro tier instance was perfect for this.<h2>Automation Goals</h2>Let&apos;s formalize what I specifically wanted to accomplish with Huginn. Note that this is a small subset of the things possible with Huginn - check out the project&apos;s <a target="_blank" rel="noopener noreferrer nofollow" href="https://github.com/huginn/huginn#here-are-some-of-the-things-that-you-can-do-with-huginn">Github</a> for more inspiration.<ul><li>Twitter notifications: whenever keywords of interest are tweeted (such as my projects or blog), I want to get notified immediately. Whenever a spike occurs for other keywords (&quot;San Francisco Emergency&quot;), notify me.</li><li>Hacker news notifications: whenever an article hits the frontpage discussing something I&apos;m interested in, notify me.</li><li>Flight deals: if a flight deal is posted online to one of the many websites I follow (Secret Flying, ThePointsGuy, FlyerTalk), and the flight originates from a nearby airport, notify me.</li><li>Product deals: if a product I&apos;m interested in is posted on Slickdeals, notify me.</li><li>Amazon price drops: if a product I&apos;m interested in drops below some predefined price threshold, notify me.</li></ul>I want all notifications to be sent to me via a personal Slack workspace, on different channels.<h2>Deploying Huginn</h2><h3>Prerequisites</h3>The easiest way to <a target="_blank" rel="noopener noreferrer nofollow" href="https://github.com/huginn/huginn/blob/master/doc/docker/install.md">install Huginn</a> is via Docker. Luckily, Google Compute Engine supports deploying Docker containers natively on a lean <a target="_blank" rel="noopener noreferrer nofollow" href="https://cloud.google.com/container-optimized-os/docs">container-optimized OS</a>.There are a few key things we need to do in order to have a successful Huginn deploy on the f1-micro (free tier) instances.Enable and create a swap file.f1-micro instances have 614MB of memory. This is not enough to run Huginn out of the box - doing so will cause Docker to encounter <code>Error Code 137</code> <a target="_blank" rel="noopener noreferrer nofollow" href="https://success.docker.com/article/what-causes-a-container-to-exit-with-code-137">(out of memory)</a> errors. To solve this, we need to create a swap file in the VM. Note that a swapfile will decrease the performance of Huginn - if you&apos;re interested in better performance for a price, consider deploying on a better VM.Disk-based swap is <a target="_blank" rel="noopener noreferrer nofollow" href="https://stackoverflow.com/questions/58210222/how-to-enable-swap-swapfile-on-google-container-optimized-os-on-gce">disabled</a> by default in container-optimized OS. To enable and set the swap file every time the VM is booted, we can use a custom startup script (shown below).Mount the Huginn MySQL database to a directory on the host.By default, Huginn creates a MySQL database inside the container. This is problematic, as the container now relies on state, and your database will <a target="_blank" rel="noopener noreferrer nofollow" href="https://github.com/huginn/huginn/blob/master/docker/multi-process/README.md">get deleted every Huginn upgrade</a>. We can use a volume mount to mount the database in the container to a directory in the host. Alternatively, you can mount a persistent disk and write the database to it.<h3>Deployment on GCP using Docker</h3>Head over to GCP, create a new project, and create a new instance.On the instance creation page, use the following settings:<ul><li><code>f1-micro</code> machine type</li><li>Check &apos;Deploy a container image to this VM instance&apos;</li><li>Container image URL is <code>docker.io/huginn/huginn</code></li><li>Add a Directory volume mount. The mount and host paths should be <code>/var/lib/mysql</code></li></ul>We also need to add in a statup script. This script lets us 1) enable and turn on a swap file, and 2) change permissions of the volume mount on the host. The latter is required or MySQL won&apos;t be able to start.<pre><code>#! /bin/bash
sysctl vm.disk_based_swap=1
fallocate -l 2G /var/swapfile
chmod 600 /var/swapfile
mkswap /var/swapfile
swapon /var/swapfile
chmod 777 /var/lib/mysql</code></pre>After the VM is created, head to your VM&apos;s external URL (port 3000) and you should be greeted with the default Huginn login page!I suggest <a target="_blank" rel="noopener noreferrer nofollow" href="https://cloud.google.com/compute/docs/ip-addresses/reserve-static-external-ip-address">reserving a static external IP</a> for this VM, so the IP doesn&apos;t change. You can even take it a step further and associate this to a domain name - like <a target="_blank" rel="noopener noreferrer nofollow" href="http://automation.colinarms.com">automation.colinarms.com</a> - for ease of access.Now, let&apos;s dive into Huginn.<h2>How Huginn Works: Agents &amp; Events</h2>At a high level, Huginn relies on two key things: agents and events. Agents are things that monitor for you and create events (possibly if some criteria is met). An example agent is an <code>RssAgent</code>, which monitors an RSS feed for new articles. Events created by the <code>RssAgent</code> can be passed to a <code>TriggerAgent</code>, which uses some regex filter to only listen to keywords of interest; and finally it emits a formatted message, perhaps to a <code>SlackAgent</code>, that finally sends a message to a Slack channel.You can imagine how this works in practice. For the flight deals usecase, for example: we can create an <code>RssAgent</code> for the <a target="_blank" rel="noopener noreferrer nofollow" href="https://www.secretflying.com/feed/">Secret Flying RSS feed</a>. The <code>TriggerAgent</code> can listen to these events, filter for &quot;San Francisco Airport&quot;, and the <code>SlackAgent</code> can message my <code>#flights</code> channel when this happensMultiple agents for a single usecase can be grouped into a <code>Scenario</code> - in the above example, a <code>Flight Deal Scenario</code> would make sense.Let&apos;s walk through this example. If you want to get started immediately, you can <a target="_blank" rel="noopener noreferrer nofollow" href="https://gist.github.com/seeARMS/103b3399f3f925fb6c366600f0bad3c6">download my agents</a> and import them into Huginn directly.<h2>Creating your First Agent</h2><h3>1) Monitoring the RSS feed</h3>On Huginn, create a new RSS Agent. Configure the following params:<ul><li>Name your agent something descriptive. I used &quot;Secret Flying RSS Agent&quot;.</li><li>Schedule your agent for however frequently you&apos;d like it to check for updates. I used 30 mins.</li><li>Keep events for some period of time. I used 7 days.</li></ul>Use the following JSON in the options:<pre><code>{
 &quot;expected_update_period_in_days&quot;: &quot;2&quot;,
 &quot;clean&quot;: &quot;true&quot;,
 &quot;url&quot;: &quot;https://www.secretflying.com/feed/&quot;
}
</code></pre>Expected update period is the period at which Huginn should expect the agent to be updated - if it doesn&apos;t happen, the agent is considered not working.Save your agent, and give it a manual run - you should see events populate from the underlying feed.<h3>2) Filtering for nearby airports</h3>Now, create a <code>TriggerAgent</code>. We want to filter newly posted articles for only nearby airports - in my case, San Francisco or San Jose airport.Fill it out similar to the first agent. But, this time select your RSS Agent as this agent&apos;s <code>source</code>. Events from the RSS Agent will be fed into this.Use the following JSON in the options:<pre><code>{
 &quot;expected_receive_period_in_days&quot;: &quot;2&quot;,
 &quot;keep_event&quot;: &quot;false&quot;,
 &quot;rules&quot;: [
 {
 &quot;type&quot;: &quot;regex&quot;,
 &quot;value&quot;: &quot;(sfo|san francisco|sjc|san jose)&quot;,
 &quot;path&quot;: &quot;title&quot;
 }
 ],
 &quot;message&quot;: &quot;[Secret Flying] &lt;a href=\&quot;{{url}}\&quot;&gt;{{title}}&lt;\/a&gt; {{description}}&quot;
}
</code></pre>We&apos;re filtering the RSS feed&apos;s title to contain my nearby airports, and emitting a <code>message</code> with the URL, title and a description.<h3>3) Notifying on Slack</h3>Lastly, create a <code>SlackAgent</code>. After <a target="_blank" rel="noopener noreferrer nofollow" href="https://slack.com/get-started#/">registering a new Slack workspace</a> and <a target="_blank" rel="noopener noreferrer nofollow" href="https://my.slack.com/services/new/incoming-webhook">creating a new Slack webhook</a>, set the <code>source</code> to the Trigger Agent you just created.Put the following JSON in the options:<pre><code>{
 &quot;webhook_url&quot;: &quot;https://hooks.slack.com/services/your-webhook-url&quot;,
 &quot;channel&quot;: &quot;#flights&quot;,
 &quot;username&quot;: &quot;Huginn&quot;,
 &quot;message&quot;: &quot;{{message}}&quot;,
 &quot;icon&quot;: &quot;&quot;
}
</code></pre>Save your agent, and eventually you should begin receiving flight deals!<div><div class="react-component" data-drag-handle="true" data-node-view-wrapper="" style="white-space:normal"><img src="https://storage.googleapis.com/papyrus_images/ee7b868109ff0eb7bb8dc89ed2920083" class="image-node img-center embed"/></div></div><h2>Wrapping it up</h2>This example describes a single usecase for what&apos;s possible with Huginn. If you&apos;re interested in the other usecases I described above, you can <a target="_blank" rel="noopener noreferrer nofollow" href="https://gist.github.com/seeARMS/103b3399f3f925fb6c366600f0bad3c6">download and import them</a> into your own installation.This post just scratches the surface of what&apos;s possible. With Huginn, let your <code>Agents</code> monitor on your behalf and free up your time for more important things.

Paragraph is a blazing-fast, privacy-first, no-frills-attached blogging & newsletter platform. Sign up and start writing posts just like this one.

Productivity & automation tools can be powerful. I was delighted to come across a recent thread on Hacker News discussing a supercharged automation tool: Huginn. This open-source software performs automated tasks by using 'agents' to watch for 'events', and triggering 'actions' based on these events.
For example, if there's a sudden spike in discussion on Twitter with the terms "San Francisco Earthquake", Huginn can send a text to my phone. Or, if a time-sensitive flight deal is posted on one of the many deal-finding websites out there, Huginn can send me an email with the price and a link to Google Flights.
Compared to other popular automation tools (IFTTT, Zapier), Huginn has the following benefits:

Self-hosted & completely private

Powerful data processing: write your own JS or use shell scripts

Liquid templating

I wanted to go beyond just automation and introduce some organization - I wanted all notifications to be cataloged & delivered in a centralized way. A personal Slack workspace seemed like the perfect solution for this - I can have a #flights channel for flight deals, or a #trending channel for the, er, pending San Francisco emergencies.
I also wanted all of this to be free. Huginn has pretty lax runtime resource requirements (even able to run on a Raspberry Pi, with some tweaking), so a free GCP micro tier instance was perfect for this.
Automation Goals
Let's formalize what I specifically wanted to accomplish with Huginn. Note that this is a small subset of the things possible with Huginn - check out the project's Github for more inspiration.

Twitter notifications: whenever keywords of interest are tweeted (such as my projects or blog), I want to get notified immediately. Whenever a spike occurs for other keywords ("San Francisco Emergency"), notify me.

Hacker news notifications: whenever an article hits the frontpage discussing something I'm interested in, notify me.

Flight deals: if a flight deal is posted online to one of the many websites I follow (Secret Flying, ThePointsGuy, FlyerTalk), and the flight originates from a nearby airport, notify me.

Product deals: if a product I'm interested in is posted on Slickdeals, notify me.

Amazon price drops: if a product I'm interested in drops below some predefined price threshold, notify me.

I want all notifications to be sent to me via a personal Slack workspace, on different channels.
Deploying Huginn
Prerequisites
The easiest way to install Huginn is via Docker. Luckily, Google Compute Engine supports deploying Docker containers natively on a lean container-optimized OS.
There are a few key things we need to do in order to have a successful Huginn deploy on the f1-micro (free tier) instances.
Enable and create a swap file.
f1-micro instances have 614MB of memory. This is not enough to run Huginn out of the box - doing so will cause Docker to encounter Error Code 137 (out of memory) errors. To solve this, we need to create a swap file in the VM. Note that a swapfile will decrease the performance of Huginn - if you're interested in better performance for a price, consider deploying on a better VM.
Disk-based swap is disabled by default in container-optimized OS. To enable and set the swap file every time the VM is booted, we can use a custom startup script (shown below).
Mount the Huginn MySQL database to a directory on the host.
By default, Huginn creates a MySQL database inside the container. This is problematic, as the container now relies on state, and your database will get deleted every Huginn upgrade. We can use a volume mount to mount the database in the container to a directory in the host. Alternatively, you can mount a persistent disk and write the database to it.
Deployment on GCP using Docker
Head over to GCP, create a new project, and create a new instance.
On the instance creation page, use the following settings:

f1-micro machine type

Check 'Deploy a container image to this VM instance'

Container image URL is docker.io/huginn/huginn

Add a Directory volume mount. The mount and host paths should be /var/lib/mysql

We also need to add in a statup script. This script lets us 1) enable and turn on a swap file, and 2) change permissions of the volume mount on the host. The latter is required or MySQL won't be able to start.
#! /bin/bash
sysctl vm.disk_based_swap=1
fallocate -l 2G /var/swapfile
chmod 600 /var/swapfile
mkswap /var/swapfile
swapon /var/swapfile
chmod 777 /var/lib/mysql
After the VM is created, head to your VM's external URL (port 3000) and you should be greeted with the default Huginn login page!
I suggest reserving a static external IP for this VM, so the IP doesn't change. You can even take it a step further and associate this to a domain name - like automation.colinarms.com - for ease of access.
Now, let's dive into Huginn.
How Huginn Works: Agents & Events
At a high level, Huginn relies on two key things: agents and events. Agents are things that monitor for you and create events (possibly if some criteria is met). An example agent is an RssAgent, which monitors an RSS feed for new articles. Events created by the RssAgent can be passed to a TriggerAgent, which uses some regex filter to only listen to keywords of interest; and finally it emits a formatted message, perhaps to a SlackAgent, that finally sends a message to a Slack channel.
You can imagine how this works in practice. For the flight deals usecase, for example: we can create an RssAgent for the Secret Flying RSS feed. The TriggerAgent can listen to these events, filter for "San Francisco Airport", and the SlackAgent can message my #flights channel when this happens
Multiple agents for a single usecase can be grouped into a Scenario - in the above example, a Flight Deal Scenario would make sense.
Let's walk through this example. If you want to get started immediately, you can download my agents and import them into Huginn directly.
Creating your First Agent
1) Monitoring the RSS feed
On Huginn, create a new RSS Agent. Configure the following params:

Name your agent something descriptive. I used "Secret Flying RSS Agent".

Schedule your agent for however frequently you'd like it to check for updates. I used 30 mins.

Keep events for some period of time. I used 7 days.

Use the following JSON in the options:
{
 "expected_update_period_in_days": "2",
 "clean": "true",
 "url": "https://www.secretflying.com/feed/"
}

Expected update period is the period at which Huginn should expect the agent to be updated - if it doesn't happen, the agent is considered not working.
Save your agent, and give it a manual run - you should see events populate from the underlying feed.
2) Filtering for nearby airports
Now, create a TriggerAgent. We want to filter newly posted articles for only nearby airports - in my case, San Francisco or San Jose airport.
Fill it out similar to the first agent. But, this time select your RSS Agent as this agent's source. Events from the RSS Agent will be fed into this.
Use the following JSON in the options:
{
 "expected_receive_period_in_days": "2",
 "keep_event": "false",
 "rules": [
 {
 "type": "regex",
 "value": "(sfo|san francisco|sjc|san jose)",
 "path": "title"
 }
 ],
 "message": "[Secret Flying] <a href=\"{{url}}\">{{title}}<\/a> {{description}}"
}

We're filtering the RSS feed's title to contain my nearby airports, and emitting a message with the URL, title and a description.
3) Notifying on Slack
Lastly, create a SlackAgent. After registering a new Slack workspace and creating a new Slack webhook, set the source to the Trigger Agent you just created.
Put the following JSON in the options:
{
 "webhook_url": "https://hooks.slack.com/services/your-webhook-url",
 "channel": "#flights",
 "username": "Huginn",
 "message": "{{message}}",
 "icon": ""
}

Save your agent, and eventually you should begin receiving flight deals!



Wrapping it up
This example describes a single usecase for what's possible with Huginn. If you're interested in the other usecases I described above, you can download and import them into your own installation.
This post just scratches the surface of what's possible. With Huginn, let your Agents monitor on your behalf and free up your time for more important things.

Personal automation with Huginn using Slack, Docker and GCP

Learn how to solve a mismatch between the server-side and client-side in NextJS.

NextJS is powerful: it brings together the best of server-side to the best of client-side. You can build powerful applications written in React, and produce a static website which has all the speed of a regular ol’ CDN-backed website. Despite the benefits, you may sometimes hit some challenges working with both server-side rendering (SSR) and client-side hydration. One of the more common errors is when the server-side and client-side DOM doesn’t match. NextJS might complain:<pre class="dont-break-out text-sm md:text-base"><code>Expected server HTML to contain a matching &lt;div&gt; in &lt;div&gt;
</code></pre><pre class="dont-break-out text-sm md:text-base"><code>Warning: Text content did not match. Server: &quot;Log in&quot; Client: &quot;Continue to dashboard&quot;
</code></pre>Additionally, the HTML (in particular, the DOM elements) may not render correctly when viewing the webpage.<h1>Why is this happening?</h1>NextJS uses both server-side and client-side rendering together. The server serves static HTML whenever possible, and the client hydrates it to give full interactivity. If you manipulate the DOM at any time between when the server-side HTML is served and the client-side is rendered, there will be a mismatch and React will not be able to hydrate the DOM successfully. Thus, the first render of any page must match the initial render of the server. This is explained more in-depth in <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out " href="https://github.com/vercel/next.js/discussions/17443">this Github issue.</a> I encountered this issue when relying on cookies. I was doing something like this:<pre class="dont-break-out text-sm md:text-base"><code>const user = Cookies.get(&apos;jwt&apos;)
if (user?.id) {
 return &lt;span&gt;User logged in!&lt;/span&gt;
}
return &lt;span&gt;User not logged in!&lt;/span&gt;
</code></pre>Cookies are only accessible in the browser, so when the server provides the static HTML the user would not be logged in, but when the client is rendered, the user would be logged in! Hence, there is a mismatch and NextJS will complain.<h1>How do I fix this?</h1>Put all browser-only code inside <code>useEffect</code>. This ensures that the client is rendered before the DOM is updated. This means the client-side and server-side DOM will match.<blockquote>JS Tip: <code>useEffect</code> is a <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out " href="https://reactjs.org/docs/hooks-effect.html">React hook</a> that lets you issue side effects - such as updating the DOM - after the page or component is mounted. The above example can be refactored:</blockquote><pre class="dont-break-out text-sm md:text-base"><code>const [isUserLoggedIn, setIsUserLoggedIn] = useState(false)
const user = Cookies.get(&apos;jwt&apos;)
useEffect(() =&gt; {
 setIsUserLoggedIn(!!user?.id)
}, [user])
if (isUserLoggedIn) {
 return &lt;span&gt;User logged in!&lt;/span&gt;
}
return &lt;span&gt;User not logged in!&lt;/span&gt;
</code></pre>The error goes away!

NextJS is powerful: it brings together the best of server-side to the best of client-side. You can build powerful applications written in React, and produce a static website which has all the speed of a regular ol’ CDN-backed website. Despite the benefits, you may sometimes hit some challenges working with both server-side rendering (SSR) and client-side hydration. One of the more common errors is when the server-side and client-side DOM doesn’t match. NextJS might complain:
Expected server HTML to contain a matching <div> in <div>

Warning: Text content did not match. Server: "Log in" Client: "Continue to dashboard"

Additionally, the HTML (in particular, the DOM elements) may not render correctly when viewing the webpage.
Why is this happening?
NextJS uses both server-side and client-side rendering together. The server serves static HTML whenever possible, and the client hydrates it to give full interactivity. If you manipulate the DOM at any time between when the server-side HTML is served and the client-side is rendered, there will be a mismatch and React will not be able to hydrate the DOM successfully. Thus, the first render of any page must match the initial render of the server. This is explained more in-depth in this Github issue. I encountered this issue when relying on cookies. I was doing something like this:
const user = Cookies.get('jwt')
if (user?.id) {
 return User logged in!
}
return User not logged in!

Cookies are only accessible in the browser, so when the server provides the static HTML the user would not be logged in, but when the client is rendered, the user would be logged in! Hence, there is a mismatch and NextJS will complain.
How do I fix this?
Put all browser-only code inside useEffect. This ensures that the client is rendered before the DOM is updated. This means the client-side and server-side DOM will match.

JS Tip: useEffect is a React hook that lets you issue side effects - such as updating the DOM - after the page or component is mounted. The above example can be refactored:

const [isUserLoggedIn, setIsUserLoggedIn] = useState(false)
const user = Cookies.get('jwt')
useEffect(() => {
 setIsUserLoggedIn(!!user?.id)
}, [user])
if (isUserLoggedIn) {
 return User logged in!
}
return User not logged in!

The error goes away!

NextJS: server-side and client-side mismatch

Photoshop Hijacks Your Cursor

Use the power of Vim, ALE and ESLint to automagically remove all unused imports from your Javascript files.

Paragraph is a blazing-fast, privacy-first, no-frills-attached blogging platform. <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://papyrus.dev?utm_source=papyrus&amp;utm_medium=blogpost&amp;utm_campaign=unused_imports_vim_ale">Sign up</a> and start writing posts just like this one.<hr><a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://github.com/eslint/eslint">ESLint</a> provides checks (and auto-fixes!) for a large list of Javascript and Typescript violations. Paired with a Vim plugin called <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://github.com/dense-analysis/ale">ALE</a>, these fixes can run on every save.This blogpost details how to set up ESLint and ALE in Vim, and uses a single usecase - removing unused imports &amp; variables - as an illustration of how powerful these tools are.<img src="https://storage.googleapis.com/papyrus_images/d4746c5999e28bd839764a46e87ec096" alt="" float="none" class="image-node img-center embed"><h3>Unused Imports &amp; Variables</h3>At the start of a a new React project, I create many different components, and I bootstrap them by copying &amp; pasting component files. This can quickly lead to a large mess of unused imports &amp; variable declarations:Let’s see how we can remove them - automatically - using the power of ESLint and Vim.<img src="https://storage.googleapis.com/papyrus_images/b927ecacf802db7ad5d5c9d2f8bbc057" alt="" float="none" class="image-node img-center embed"><h3>Configuring ESLint</h3>The core solution to this problem is a handy ESLint plugin called <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://www.npmjs.com/package/eslint-plugin-unused-imports">eslint-plugin-unused-imports</a>. (Other solutions I found online rely on TSList, which is deprecated, so an ESLint-based solution is preferred).Let’s install ESLint, as well as the <code>eslint-plugin-unused-imports</code> plugin:<pre class="dont-break-out text-sm md:text-base"><code>yarn add -D eslint
yarn add -D eslint-plugin-unused-imports
</code></pre>Now, modify your <code>.eslintrc</code> to enable the plugin:<pre class="dont-break-out text-sm md:text-base"><code>// .eslintrc

{
	&quot;plugins&quot;: [&quot;unused-imports&quot;]
}
</code></pre>Configure your ESLint rules to error on unused imports or unused variables:<pre class="dont-break-out text-sm md:text-base"><code>// .eslintrc

{
	&quot;rules&quot;: {
		&quot;no-unused-vars&quot;: &quot;off&quot;, // or &quot;@typescript-eslint/no-unused-vars&quot;: &quot;off&quot;,
		&quot;unused-imports/no-unused-imports&quot;: &quot;error&quot;,
		&quot;unused-imports/no-unused-vars&quot;: [
			&quot;warn&quot;,
			{ &quot;vars&quot;: &quot;all&quot;, &quot;varsIgnorePattern&quot;: &quot;^_&quot;, &quot;args&quot;: &quot;after-used&quot;, &quot;argsIgnorePattern&quot;: &quot;^_&quot; }
		]
	}
}
</code></pre>Now, we should see <code>unused-imports/no-unused-imports</code> detecting the unused imports (instead of no-unused-vars, as in the screenshot above):And running <code>eslint --fix</code> should automatically remove these imports!We can do better, though - let’s configure Vim to auto-fix on every save.<h3>Setting up ALE to auto-fix on save</h3><a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://github.com/dense-analysis/ale">ALE</a> is a plugin for Vim and NeoVim that lints as you type, and auto-fixes syntax and semantic errors. It uses ESLint (and many other extensible tools) underneath to perform the actual fixing logic.Install ALE by <a target="_blank" rel="noopener noreferrer nofollow ugc" class="dont-break-out dont-break-out" href="https://github.com/dense-analysis/ale#3-installation">following the instructions</a> and using Pathogen, Vundle, Plug, or one of the other installation options.After installing ALE, edit your <code>.vimrc</code> file set two options:<ol><li><code>let g:ale_fixers</code> - Run ESLint as a fixer in your relevant filetypes, which lets ALE tap into ESLint for fixing files</li><li><code>let g:ale_fix_on_save</code> - Automatically run all fixers on save</li></ol>It’ll look something like this:<pre class="dont-break-out text-sm md:text-base"><code>// .vimrc

let g:ale_fix_on_save = 1
let g:ale_fixers = {
\ &apos;javascript&apos;: [&apos;eslint&apos;],
\ &apos;typescript&apos;: [&apos;eslint&apos;],
\ &apos;typescriptreact&apos;: [&apos;eslint&apos;],
\}
</code></pre>Now, every time you save a <code>js</code>, <code>ts</code> or <code>tsx</code> file, <code>eslint --fix</code> will automatically run and clean up your imports &amp; unused variables!

Paragraph is a blazing-fast, privacy-first, no-frills-attached blogging platform. Sign up and start writing posts just like this one.

ESLint provides checks (and auto-fixes!) for a large list of Javascript and Typescript violations. Paired with a Vim plugin called ALE, these fixes can run on every save.
This blogpost details how to set up ESLint and ALE in Vim, and uses a single usecase - removing unused imports & variables - as an illustration of how powerful these tools are.

Unused Imports & Variables
At the start of a a new React project, I create many different components, and I bootstrap them by copying & pasting component files. This can quickly lead to a large mess of unused imports & variable declarations:
Let’s see how we can remove them - automatically - using the power of ESLint and Vim.

Configuring ESLint
The core solution to this problem is a handy ESLint plugin called eslint-plugin-unused-imports. (Other solutions I found online rely on TSList, which is deprecated, so an ESLint-based solution is preferred).
Let’s install ESLint, as well as the eslint-plugin-unused-imports plugin:
yarn add -D eslint
yarn add -D eslint-plugin-unused-imports

Now, modify your .eslintrc to enable the plugin:
// .eslintrc

{
	"plugins": ["unused-imports"]
}

Configure your ESLint rules to error on unused imports or unused variables:
// .eslintrc

{
	"rules": {
		"no-unused-vars": "off", // or "@typescript-eslint/no-unused-vars": "off",
		"unused-imports/no-unused-imports": "error",
		"unused-imports/no-unused-vars": [
			"warn",
			{ "vars": "all", "varsIgnorePattern": "^_", "args": "after-used", "argsIgnorePattern": "^_" }
		]
	}
}

Now, we should see unused-imports/no-unused-imports detecting the unused imports (instead of no-unused-vars, as in the screenshot above):
And running eslint --fix should automatically remove these imports!
We can do better, though - let’s configure Vim to auto-fix on every save.
Setting up ALE to auto-fix on save
ALE is a plugin for Vim and NeoVim that lints as you type, and auto-fixes syntax and semantic errors. It uses ESLint (and many other extensible tools) underneath to perform the actual fixing logic.
Install ALE by following the instructions and using Pathogen, Vundle, Plug, or one of the other installation options.
After installing ALE, edit your .vimrc file set two options:

let g:ale_fixers - Run ESLint as a fixer in your relevant filetypes, which lets ALE tap into ESLint for fixing files

let g:ale_fix_on_save - Automatically run all fixers on save

It’ll look something like this:
// .vimrc

let g:ale_fix_on_save = 1
let g:ale_fixers = {
\   'javascript': ['eslint'],
\   'typescript': ['eslint'],
\   'typescriptreact': ['eslint'],
\}

Now, every time you save a js, ts or tsx file, eslint --fix will automatically run and clean up your imports & unused variables!

Colin Mark Armstrong

Wallets instead of emails for identity

Spending time deliberately

Personal automation with Huginn using Slack, Docker and GCP

NextJS: server-side and client-side mismatch

Photoshop Hijacks Your Cursor

Automatically remove unused imports & variables in Vim using ALE and ESLint

Stay up to date

Work