Thingy

Discord bot to generate images based on a text prompt - way more than just that! Through a wide variety of tools, you can alter your generated images and share them with friends.

Integrates with DiscoArt, Stable Diffusion and other peculiarities, all rolled up in a single, sexy user interface that allows one to mix and match different configurations without a steeper learning curve!

• Powerful customization tools
• Fairness queue: Making sure everyone gets to make art!
• Social features: Sharing, profiles and stats
• Advanced Profile customization
• A massive upscaling feature with the ability to upscale up to 3k
• Chapters: Work on your pieces, and switch back to previous works of art!
  • Every "creation" command (/make_image, /make_audio results in a new chapter
  • Use variation commands (/upscale, /variate, ~~more to come~~) to alter said chapters as they wish
  • Don't like a change? Just do /rollback! There's unlimited undo!
  • Instantly swap back to previous chapters with /chapters

Demo video + dev journey

In short: this bot allows you to generate images based on a text prompt, but can do way more than just that - offering a wide variety of tools to make alter your generated images.

Demo art

Credits and special thanks

• First and foremost Han Xiao for being around in DMs helping me with what I struggled with but also putting me on the right direction in various moments
• DiscoArt: without this project, I was never able to cook this up in a weekend
• Jina which has some incredible tooling I got familiar with
• Mahdi Chaker for the heavy training GPUs for LEAP + Running the bot on my Discord server!

Demo

My discord server has the bot running, both alpha and production bots are up!

Run it yourself!

As this bot is open-source, anyone can run it. Depending on the method, you need different specs. The easiest is through Docker Compose as it will instantly set up everything you need.

The bot consists of 2 major parts:

• Thingy (the interface where users will interact with)
• Hydrolane (the queue system and AI loader) (which will actually run the models)

In the tutorial below, we will set up both components so you can get started.

Installing via Docker Compose

Note! As we evolved from a weekend project to a larger-scale bot, things have changed a lot, and I thank you all. Please, if you use this in your own server, do get in touch with me, so we can see what works and what doesn't. Any feedback is really appreciated! Feel free to join Thingy's birthplace or shoot a line in the projects Issues page!

What you need:

• Linux or Windows with Docker installed (Or download here)
• Discord account and bot (more on this later)
• A Nvidia GPU (Todo: support AMD, CPU, etc. Let me know if you can help testing!)

Steps:

• Create a directory where we will set up our bot, and inside this directory, create a directory called thingy_data
  • If you ran an older version of the bot, you can drop your db.sqlite here. Keep in mind the configuration has changed slightly. Otherwise, you can ignore this.
• Download config.example.yml and name it config.yml, put it into the bot directory.
• Once done, follow "Setting up the bot" and then go back here.
• Download docker-compose.yml, if you use a Nvidia GPU then you don't need to change anything. Drop this file in the same directory as where your data directory resides.
• You should now have the following list of files (correct your setup to match this tree if necessary):

   ├── docker-compose.yml
   └── thingy_data
       └── config.yml
  

• You're ready! Run docker compose up -d to start the network. Docker automatically manages downtime and user data is stored in the thingy_data directory!
• Now you should be able to run /make_image and other peculiarities in Discord! The first time it might take a while to run due to downloading models.

Setting up the bot

• Create a Discord application on their developer portal
• Make a discord bot by clicking on the Bot menu, and click "Add Bot". Name it as you like
• Click "Reset Token" to reveal the bot token. Make note of this token, you need it in the next step
• In the config.yml, change the bot name and token to your bot token
• Go to Hugginface Tokens (make an account if you don't have one yet) and create a token
  • Replace token_from_hf in config.yml with the token you just created
  • This token allows you access to the Stable Diffusion model!
• Save the config
• Go to the OAuth2 menu, and click the URL Generator submenu. Check off the Bot checkbox
• In bot permissions, you only need the following:
• After you have done this, you can copy the link and invite the bot into your server
  • The first time, the bot may be triggering a timeout error, this is because it has to download all the model files. After it's done, it'll run properly
• You can now resume the previous steps (wherever you were forwarded from)

How to enable the Share feature (optional)

• Make sure Discord is in developer mode
• Make a channel, any place you like (bot needs to be able to post to it, so make sure has write permissions there). Name it something like gallery
• Right-click on the channel and click "Copy ID"
• Paste the channel ID in shareChannelID in the bots config.yml. Restart bot if its running!
• Now you and your members can use /share for showcasing your fine art!

Sister projects

These are co-developed with Thingy!

• Keep My JCloud
• LEAP

Changelog

• 31 mar 2023: Deliberate 2 port + New sponsor for the bot
• 10 jan 2023: Added LEAP!
• 01 dec 2022: Uploaded new Docker image for Thingy 3 + fixed sharing + fixed readme instructions
• 26 sept 2022: Added Keep My JCloud as sister project, integrated in the bot using Docker. It keeps JCloud instances running by re-deploying if it dissapears.
• 21 oct 2022: Fixes for hanging cache system + sister projects updates + faster SD! + Magic Prompts!