izzilis gpt-2 bot

Meant to be used with a finetuned GPT-2 model

Usage

To run the bot, you need a valid bot_config.json file at the path where you're running the bot. If you do not have one, izzilis will generate a default one for you to fill out.

This bot currently requires a Telegram bot token to work, as there is no option to disable curation. To create a bot, please use the Botfather. Once created, and running, set a channel for the bot to post curation options in via the /setmain bot command. Usually this requires sending /setmain@bot_username to the chat with the bot (can be group chats).

This default uses the Misskey publisher. If you want to publish to Mastodon, Pleroma, or any other mastodon-compatible API, please replace Misskey in the publisher object with Mastodon.

Config values

Name	Value
python_path	The path to the system's python3 interpreter
model_name	The name of the GPT-2 model to use (see gpt-2 docs)
temperature	The temperature value to call gpt-2 with (see gpt-2 docs)
top_k	The top_k value to call gpt-2 with (see gpt-2 docs)
gpt_code_path	The path to where the gpt-2 source & models are located
interval_seconds	See interval_seconds
bot_token	Telegram Bot API token
chat_ref	The chat reference ID for the telegram bot, leave at 0, will be filled once /setmain is sent
post_buffer	How many curated samples the bot will hold at maximum at a time
publisher	See publisher

interval_seconds

Name	Value
min	Minimum amount of seconds to wait between posts
max	Maximum amount of seconds to wait between posts

publisher

The publisher can currently hold one of two JSON objects, named either Mastodon or Misskey, which determines which posting API it will use. Whether the object is Misskey or Mastodon, it has the following members:

Name	Value
base_url	The base URL of the instance
token	The auth token for the account, leave empty for Mastodon as you will be prompted to log in and authorize
visibility	The visibility scope of the statuses to be posted. These differ between publishers, see the list below

Misskey visibility values

• Public (Global)
• Home
• Followers
• Specified (DMs)

Mastodon-comptaibles visibility values

• public (Global)
• unlisted (Home)
• private (Followers only)
• direct (DMs)

An example Misskey publisher entry looks like this:

	"publisher": {
		"Misskey": {
			"base_url": "",
			"token": "",
			"visibility": "Public"
		}
	}

And for mastodon/pleroma:

	"publisher": {
		"Mastodon": {
			// Token will be set by izzilis on authentication (requires interactive)
			"base_url": "",
			"visibility": "public"
		}
	}