Show HN: Gourami – An intentionally small ActivityPub microblogging platform

Show HN: Gourami – An intentionally small ActivityPub microblogging platform

Build and Test

An intentionally tiny, ultra-light-weight ActivityPub social community. Stare a keep public demo at and attain out to me at any time when that you’d be capable of nicely love an invitation in order that that you’d be capable of nicely additionally attempt it out.


Philosophy and Kind

Gourami differs from current social networks in a name of packages:

  • Intentionally tiny — designed to provide a lift to 50-100 full of life customers. I’m decided it might presumably presumably nicely additionally beef up extra, however points might nicely even fleet turn into an enormous quantity. Gourami was massively and right away impressed by the unimaginable essay on Gourami is designed to provide a lift to reasonably tiny communities, possibly tied to a selected curiosity, neighborhood, or bodily location.
  • Decentralized — Gourami makes make use of of ActivityPub to attach separate servers, however with an implementation that differs from current ActivityPub servers resembling Mastodon. Circumstances federate on the server diploma, instead of the person diploma, that plan all customers on the server portion the identical “neighborhood”.
  • Invite-supreme and closed — a neighborhood curated by the server admin, instead of start to all. That you just simply should nicely presumably additionally eradicate to rating posts to your event public, however they’re inside most by default.
  • Free and start provide — I procure very referring to the plan wherein that the very scheme for constructing neighborhood and networking with our friends is managed by firms with doubtlessly assorted values and targets than their customers. Immense, for-income social networks private monetary incentives that distorts the pronounce and the collection of communities that would nicely invent on them. Gourami is 100% free and start provide, licensed below AGPL v3.
  • A social community with bodily context — Gourami can private to be straightforward to deploy in a bodily scheme (resembling a rental, home constructing, espresso store or wi-fi mesh network) or amongst of us in a selected bodily neighborhood, resembling a school or city. In Simple packages to Originate Nothing, Jenny Odell discusses the scarcity of a context, notably bodily and temporal context, in social media, and requires social networks which might be tied to bodily scheme. Whereas Gourami would not drive you to tie a deployment to an area, it is designed on this type of mode that this type of deployment could be reasonably straightforward.
  • Terribly lightweight & hasty — minute or no Javascript, plain textual pronounce, tiny web page sizes. Would possibly presumably nicely nonetheless wander on extraordinarily lightweight/low-payment {hardware} and low-bandwidth networks.
  • Susceptible-college and Brutalist — Stark and minimal, the make and interface can private to emphasize, instead of cowl, the underlying constructing blocks of the acquire that comprise it. This might nicely even merely give Gourami a really feel similar to 90s or 2000s internet boards, or Twitter circa 2009.
  • Easy and personal-averse — A extra simple Gourami is an extended far more simple for me to invent, beef up and protect. I would like Gourami to be excellent software that of us can plan communities on prime of, and severely limiting the characteristic position makes that worthy extra simple. After I rating Gourami to a decided core characteristic position, my work will likely be devoted to upkeep and care, instead of characteristic additions. This might nicely even merely allow of us to invent lengthy-term, staunch social networks, and moreover invent forks with out caring about shedding upstream changes.

Features that are not performed but:

  • Mastodon/different AP server interop — Gourami manages identities in a significantly assorted plan than Mastodon and different ActivityPub microblogging firms and merchandise. I really private experimented with Mastodon interop and it really works to a pair diploma, however I do not are searching to formally beef up it till it is extra staunch. It is at present disabled.

Native Set up

Be decided you private the following dependencies:

  • sqlite3
  • libsqlite3-dev
  • openssl

Set up Rustup or Cargo.

Clone this repository with git clone

Run cargo arrange --course .

Configuration is completed by dotenv. For sample and testing, the sample_env file is suitable to start — copy it to .env in the identical itemizing that you simply’re working gourami.

Setup the database with diesel cli — cargo arrange diesel_cli and diesel setup, or right wander all the up.sql scripts within the migrations/ folder.

Run the native server with gourami_social wander

To place a person fantasy:

  • Run the sql elaborate insert into registration_keys values ("123")
  • Inch to http://localhost: 3030/register?key=123
  • Make an fantasy and log in


Gourami is in alpha / sample stage.

I’d truly like everytime you gave Gourami a shot, however do not forget that issues might nicely even merely come up. Every time that you’d be capable of nicely be searching to watch or be a part of my server, please attain out to me! I’m moreover satisfied to alleviate any particular person position up their event. Extra recordsdata on developing a server is readily available within the admin handbook.


Many initiatives impressed my work proper right here, and I are searching to say them.

Brand from


Please enter your comment!
Please enter your name here