Bootleg bot: Difference between revisions

From XPUB & Lens-Based wiki
No edit summary
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Networking==
''This page is prepared for the prototyping class on 3 March 2026 as part of SI29 and follows a Special Issue day with Doriane and Simon fully on topic of [[The bootleg library]].''


🟣 = a device (server/laptop/phone/...)
https://git.xpub.nl/kamo/bot-magic-words
🟡 = a network


We will go through the following commands from 🟣 sergio.


So the first step is to log into 🟣 sergio:
==the zulip bot==


ssh sergio
First install the requirements listed on this page:


To which networks is 🟣 sergio connected right now?
https://zulip.com/help/writing-bots


ip a
You can run the bot with:


To which networks is 🟣 the bootleg library connected right now?
zulip-run-bot --config-file bootlegbot.zuliprc bootlegbot.py


<pre>
(or <code>uv run zulip-run-bot --config-file bootlegbot.zuliprc bootlegbot.py</code> if you are using uv)
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
      valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host
      valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether dc:a6:32:54:34:1c brd ff:ff:ff:ff:ff:ff
    inet 145.24.153.55/23 brd 145.24.153.255 scope global dynamic noprefixroute eth0
      valid_lft 207029sec preferred_lft 174629sec
    inet6 fe80::9e59:5f86:ee6:e86d/64 scope link
      valid_lft forever preferred_lft forever
3: wlan0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
    link/ether dc:a6:32:54:34:1e brd ff:ff:ff:ff:ff:ff
    inet 10.9.8.1/24 brd 10.9.8.255 scope global noprefixroute wlan0
      valid_lft forever preferred_lft forever
    inet6 fe80::9724:36ee:d995:558e/64 scope link
      valid_lft forever preferred_lft forever
4: hub: <POINTOPOINT,MULTICAST,NOARP,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UNKNOWN group default qlen 500
    link/none
    inet 10.0.0.103/24 scope global hub
      valid_lft forever preferred_lft forever
    inet6 fe80::6fce:6106:9b56:33db/64 scope link stable-privacy
      valid_lft forever preferred_lft forever
</pre>


Is 🟣 sergio part of the same network as 🟣 the bootleg library is?
===bootlegbot.py===


...
<syntaxhighlight lang="python">
class BootlegBot(object):
    '''
    This is a small zulip bot to interact with the 👢🦵 library
    '''


How can we check if we can communicate with 🟣 the bootleg library through this network?
    def usage(self):
        return '''Ask the bot about a book and they will search for it in the 👢🦵 library'''


ping ip-address
    def handle_message(self, message, bot_handler):
        # This happens when someone write to the bot


Let's first check 🟡 the XPUB HUB (see all servers listed [[HUB|here]])
        sender = message['sender_full_name']
        content = message['content']
        print(f'{sender} wrote to the bot: "{content}"')


ping 10.0.0.103
handler_class = BootlegBot
</syntaxhighlight>


Who else is on 🟡 the HUB network right now?
===bootlegbot.zuliprc===


nmap 10.0.0.*
<pre>
[api]
email=bootleg-bot@zulip.xpub.nl
key=XXXXXXXX
site=https://zulip.xpub.nl
</pre>


And who else is on 🟡 eduroam right now? (in the same subnet)
We need to share the key with each other somehow.


nmap 145.24.152.*
===Zulip bot API===


Can we reach 🟣 the bootleg library through 🟡 eduroam?
https://zulip.com/help/interactive-bots-api


ping 145.24.153.55
==hello Python!==


We can make such a mapping because we are part of the same LAN network.
see: [[Hello Python]]


LAN = local area network
==SSH to bootleg library==


Let's take a short side step.
There are two ways in which we can do this.


We want to make a zulip bot. Which network do we use everyday to connect to 🟣 the XPUB zulip server?
===laptop > sergio > bootleg library (from outside the school)===


  ping zulip.xpub.nl
  ssh sergio
  <check your ip address from your device>
  sudo su - xpub
 
  ssh pi@10.0.0.103
How does such a zulip connection travel?
 
traceroute zulip.xpub.nl
 
We can trace this route because all the "hops" are done on 🟡 the public internet (the WAN).
 
WAN = wider area network, aka the internet
 
So to summarize, these devices are part of the following networks:
 
  🟣 bootleg library: 🟡 10.0.0.103 + 🟡 145.24.153.55
🟣 sergio:
🟣 your laptop:
🟣 XPUB zulip server:
 
With an important footnote: we're not sure if it was intentional to have 🟣 the bootleg library on 🟡 eduroam. So let's keep in mind that we will most likely loose this connection.


Which 🟣 device can we use to run a bot that connects the 🟣 XPUB zulip server to 🟣 the bootleg library (on 🟡 the HUB), keeping in mind that the whole goal of this is to connect to 🟣 the bootleg library from 🟡 the WAN?
===laptop > bootleg library (on eduroam)===
ssh pi@145.24.153.55


...
==read database==


How can we connect 🟣 our device (on 🟡 WAN) to 🟣 sergio (on 🟡 eduroam + 🟡 HUB) to connect to 🟣 the bootleg library (on 🟡 eduroam + 🟡 HUB)?
* Simon and Luke made this Python script in 2021, to make the temporary index cards: https://git.vvvvvvaria.org/simoon/temporary-indexing
* documentation of sqlite module in Python: https://docs.python.org/3/library/sqlite3.html


in many ways...
==write to database==


But which option will we focus on today?
* a standalone webform for file uploads
* using the bootleg library upload URLs
* hosted on sergio (but can be hosted on another sandbox too in the future)


SSH tunnelling!
==See also==


==SSH tunnelling==
* [[The bootleg library]] main documentation page of the bootleg library project
* https://cc.practices.tools/etherdot/bootleg-library/ graph based story of the bootleg library project


https://ittavern.com/visual-guide-to-ssh-tunneling-and-port-forwarding/
[[Category:Workbooks]]

Latest revision as of 11:20, 24 March 2026

This page is prepared for the prototyping class on 3 March 2026 as part of SI29 and follows a Special Issue day with Doriane and Simon fully on topic of The bootleg library.

https://git.xpub.nl/kamo/bot-magic-words


the zulip bot

First install the requirements listed on this page:

https://zulip.com/help/writing-bots

You can run the bot with: 

zulip-run-bot --config-file bootlegbot.zuliprc bootlegbot.py

(or uv run zulip-run-bot --config-file bootlegbot.zuliprc bootlegbot.py if you are using uv)

bootlegbot.py

class BootlegBot(object):
    '''
    This is a small zulip bot to interact with the 👢🦵 library
    '''

    def usage(self):
        return '''Ask the bot about a book and they will search for it in the 👢🦵 library'''

    def handle_message(self, message, bot_handler):
        # This happens when someone write to the bot

        sender = message['sender_full_name']
        content = message['content']
        print(f'{sender} wrote to the bot: "{content}"')

handler_class = BootlegBot

bootlegbot.zuliprc

[api]
email=bootleg-bot@zulip.xpub.nl
key=XXXXXXXX
site=https://zulip.xpub.nl

We need to share the key with each other somehow.

Zulip bot API

https://zulip.com/help/interactive-bots-api

hello Python!

see: Hello Python

SSH to bootleg library

There are two ways in which we can do this.

laptop > sergio > bootleg library (from outside the school)

ssh sergio
sudo su - xpub
ssh pi@10.0.0.103

laptop > bootleg library (on eduroam)

ssh pi@145.24.153.55

read database

write to database

  • a standalone webform for file uploads
  • using the bootleg library upload URLs
  • hosted on sergio (but can be hosted on another sandbox too in the future)

See also

Retrieved from "https://pzwiki.wdka.nl/mw-mediadesign/index.php?title=Bootleg_bot&oldid=328624"