#terminal #compiler #web

app shitpost

A compile-time Markov bot creator for the Fediverse

3 stable releases

1.0.2 May 27, 2024

#330 in Web programming

49 downloads per month

JSON license

18KB
149 lines

Installation | URL Formats | Key Generation | Command Usage

Shitpost

GitHub Overengineered Crates.io

A compile-time Markov bot creator for the Fediverse.

Installation

Because the bot is generated at compile time, you need to pass it some environment variables at build time in order for it to retrieve posts to train on.

Variable Required Description
$SHITPOST_IN true The URL to retrieve posts from to train the bot. Training a bot on posts that aren't you're own is generally considered a 'dick move'. Don't be a dick.
$SHITPOST_KEY false A private key with read permissions. If this is set, the bot will be able to train off of non-public posts. The key is only used whilst training the bot and is stored nowhere in the compiled binary.
$SHITPOST_OUT false The URL to send new posts to. If not set then the bot will not be able to automatically send posts.
$SHITPOST_SUFFIX false An optional suffix to append to each post, usually to indicate that the post was generated.
$SHITPOST_VISIBILITY false A visibility to apply to all posts. Posts are public by default. Accepted value: public, unlisted or private.
$SHITPOST_CW false A content warning to apply to all posts.

[!NOTE] Compilation may take a long time, This is because requests for posts have to be sent one at a time (With each request retrieving 40 posts).

If you can solve this problem, let me know, and I'll be able to dramatically speed up compile times.

URL Formats

The URLs for $SHITPOST_IN and $SHITPOST_OUT should be API endpoints for the Fediverse software you are using, generally these will be of the form:

In: https://<instance>/api/v1/accounts/<username or id>/statuses

Out: https://<instance>/api/v1/statuses

[!NOTE] The account the posts are sent to is not part of the URL and determined by the private write key given at runtime.

Key Generation

shitpost-rs needs an API key in order to automatically send posts to a Fedi accounts, as well as read non-private posts if you want to train off of those.

shitpost-rs doesn't provide any authentication services. Instead you need to provite your own. If you don't already have one, you can generate one from one of these sites:

[!CAUTION] I'm not associated with either of these sites; It's your own responsibility to make sure you trust them, or for that matter, that you trust this. They're both open source, make your own judgements if you feel it necessary.

Command Usage

Calling the shitpost binary without any arguments will simply print the generated post to the terminal in HTML format.

In order to automatically send posts, a private key must be provided as an argument, as it would be a bad idea to store it in the binary.

You can pass it as the first argument, or pass - as the first argument, in which case it will read a key from stdin.

Dependencies

~6–17MB
~237K SLoC