https://github.com/linqlover/telegramsmalltalkbot
A Telegram bot that connects you to a remote Squeak/Smalltalk image and allows you to explore it by sending Smalltalk expressions to the bot.
https://github.com/linqlover/telegramsmalltalkbot
hacktoberfest repl smalltalk squeak telegram-bot
Last synced: about 2 months ago
JSON representation
A Telegram bot that connects you to a remote Squeak/Smalltalk image and allows you to explore it by sending Smalltalk expressions to the bot.
- Host: GitHub
- URL: https://github.com/linqlover/telegramsmalltalkbot
- Owner: LinqLover
- Created: 2020-11-01T14:43:33.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-11T22:32:05.000Z (over 1 year ago)
- Last Synced: 2025-04-05T15:27:24.832Z (11 months ago)
- Topics: hacktoberfest, repl, smalltalk, squeak, telegram-bot
- Language: Smalltalk
- Homepage: https://t.me/SqueakSmalltalkBot
- Size: 34.5 MB
- Stars: 12
- Watchers: 1
- Forks: 1
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TelegramSmalltalkBot
[](https://github.com/LinqLover/TelegramSmalltalkBot/actions)
[](https://coveralls.io/github/LinqLover/TelegramSmalltalkBot)
[](https://t.me/SqueakSmalltalkBot)
A Telegram bot that connects you to a remote [Squeak/Smalltalk](https://squeak.org/) image and allows you to explore it by sending Smalltalk expressions to the bot.
Implemented using the [TelegramBot framework](https://github.com/LinqLover/TelegramBot) and [SimulationStudio](https://github.com/LinqLover/SimulationStudio) for sandboxed execution.
Currently available features include, but are not limited to:
- Evaluate arbitrary Smalltalk expressions
- Multi-user object memory with isolated execution to rule out global side effects in the image
- Select the receiver context (`self`) for your expressions by replying to a specific previous message of the bot
- Edit your messages and answers from the bot will be updated as well
- Multi-media representations of various Smalltalk objects such as `Text`, `Form`, `AnimatedImageMorph`, `AbstractSound`, and others
- Bot commands to create different views of expression results such as `/do`, `/print`, and `inspect`
To learn more about all capabilities, just [try it out](#try-it-out) and send the `/help` command.
There is also a [screencast available on YouTube](https://youtu.be/HZCeThLqQmg).
## Try it out!
An instance of the bot is live under [@SqueakSmalltalkBot](https://t.me/SqueakSmalltalkBot).
Just send it a message and say hello!
If you experience any problems, please [create an issue](https://github.com/LinqLover/TelegramSmalltalkBot/issues/new/choose).
## Self-Hosting the Bot
1. Install the latest Trunk updates in your image, then evaluate the following in a Workspace:
```smalltalk
Metacello new
baseline: 'TelegramSmalltalkBot';
githubUser: 'LinqLover' project: 'TelegramSmalltalkBot' path: 'src';
load.
```
2. Chat with [@BotFather](https://t.me/BotFather) to register your very own bot.
He will send you a secret bot token.
3. To start a bot instance, do something like:
```smalltalk
bot := TelegramSmalltalkBot withToken: ''.
bot spawnNewProcess.
```
4. Send a message to your bot and enjoy!
5. If you do not want that everyone from all over the world has access to your bot, you can define an allow-list of chat IDs and provide it via the `TBTestBotChatIds` global variable (experimental):
```smalltalk
Smalltalk at: #TBTestBotChatIds put: #().
```
You can find out your own chat ID by browsing the sessions object of your running bot instance using an object explorer, or by inspecting the result of `bot peekUpdates` after sending a message to the bot.
For more information on how to run the bot, read the docs of the [TelegramBot framework](https://github.com/LinqLover/TelegramBot#usage).
Configuration of the bot (e.g. to turn off isolation and quota mechanisms) is currently only supported by editing the source code, though it contains some applicable hooks such as `TelegramSmalltalkSession >> #isolationEnabled`.
If you miss a certain configuration hook or extension point, please create an issue or a pull request.
For more information on the architecture and set-up of this bot, please refer to [this overview](https://linqlover.github.io/LinqLover/slides/SqueakEv21W%20TelegramBot.pdf#page=2).
There is also an inofficial setup tutorial available that was written by [@cstes](https://github.com/cstes): [Running a TelegramSmalltalkBot in a minimal zone on Oracle Solaris 11](https://master.dl.sourceforge.net/project/solaris-squeak/tbot21.pdf) ([mirror](https://web.archive.org/web/20231128210657/https://master.dl.sourceforge.net/project/solaris-squeak/tbot21.pdf?viasf=1))
## Development
Version control is run using [Squot](https://github.com/hpi-swa/Squot).
Your contribution is welcome!
I'm always happy about bug reports, new feature proposals, or even pull requests ... :-)
Carpe Squeak!
