Play with TJBot

TJBot comes with a number of recipes, which are pre-configured behaviors that use TJBot's capabilities, such as speaking, seeing, and shining the LED. Recipes are code that tells TJBot how to interact with you!

TJBot recipes

TJBot comes with a number of recipes to showcase its different behaviors. They are:

• Chat with TJ: Converse with TJBot using IBM watsonx.ai
• Disco Party: Control TJBot's LED with your voice
• Hello TJBot: Say hello, TJBot
• Parrot: Turn TJBot into a parrot
• Peekaboo: Play peekaboo with TJBot
• TJ Says: Play a game of TJ Says
• TJ the Translator: Speak another language with TJBot
• What Do You See: TJ, TJ, what do you see?

Recipe configuration

Some of TJBot's recipes need to be configured before they can be used. For example, Chat with TJ uses IBM's watsonx.ai service and TJ the Translator uses the Google Cloud Translation service. Be sure to check each recipe's README to understand how to configure these services!

How to run a recipe

Recipes are run using the tjbot command:

tjbot run [recipe_name]

Under the hood, when you run a recipe, the mise task runner makes sure all of the recipe's software dependencies are installed. The first time you run a recipe, mise will ask you if you trust the files in that directory:

mise config files in ~/.tjbot/tjbot/recipes/chat_with_tj are not trusted. Trust them?


 [  Yes  ] [  No  ] [  All  ]

←/→ toggle • y/n/a/enter submit

It is safe to say "Yes" to this prompt.

Recipe customization

Many recipes have different ways they can be customized or extended. These customizations are documented in each recipe's README. Think of them as exercises for you to learn how to program your TJBot! We encourage you to be creative and think of new ways to extend these recipes or create your own!

What's Next

Congratulations, you have successfully built and played with your very own TJBot! You should be very proud! 🤖❤️

At this point, there are a few next steps you can take:

• Looking to have more fun with TJBot? Check out our curated list of Community Recipes for recipes created by members of the #tjbot community.
• Is your TJBot not quite working correctly? Check out our troubleshooting guide.
• Are you ready to create your own recipes? Check out our instructions on how to develop for TJBot.
• Want to contribute to TJBot: Community Edition? Check out our contributor's guide.

We can't wait to see what you build with TJBot!