ccl/bots-of-conduct
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

markup changes

Browse Source
This commit is contained in:
mb 2020-06-10 21:06:25 +02:00
parent b9906e847c
commit 6a1abe8691
1 changed files with 34 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

82
README.md
View File

@ -22,7 +22,6 @@ A few examples:
* [CluebotNG](https://en.wikipedia.org/wiki/User:ClueBot_NG) * [CluebotNG](https://en.wikipedia.org/wiki/User:ClueBot_NG)
* [How to do anything](https://mastodon.social/@wikihow) * [How to do anything](https://mastodon.social/@wikihow)
**Bots as Tools to Intervene in Conversations** **Bots as Tools to Intervene in Conversations**
What would it mean to become more entangled with bots, redistribute the labour of making and maintaining a collective, but without falling into the metaphorical understanding of bot as a servant? What would it mean to become more entangled with bots, redistribute the labour of making and maintaining a collective, but without falling into the metaphorical understanding of bot as a servant?
@ -37,62 +36,51 @@ Currently, we use:
* [Streambot](https://git.vvvvvvaria.org/varia/xmpp.streambot): a bot that saves the images sent to the main Varia group chat and creates an [html page](https://vvvvvvaria.org/stream/) for them. * [Streambot](https://git.vvvvvvaria.org/varia/xmpp.streambot): a bot that saves the images sent to the main Varia group chat and creates an [html page](https://vvvvvvaria.org/stream/) for them.
* [Logbot](https://git.vvvvvvaria.org/varia/logbot): a bot that [logs](https://vvvvvvaria.org/logs/) the quotes that are sent to it. * [Logbot](https://git.vvvvvvaria.org/varia/logbot): a bot that [logs](https://vvvvvvaria.org/logs/) the quotes that are sent to it.
* You can find a genealogy of the bots around Varia in this footnote[^2] * You can find a genealogy of the bots around Varia in this footnote[^genealogy]
<br> <br>
Let's look into the bots [examples](https://git.vvvvvvaria.org/ccl/bots-of-conduct): Let's look into the bots [examples](https://git.vvvvvvaria.org/ccl/bots-of-conduct):
### Transit ### Transit
**_name:_** transit.py; **_name:_** transit.py
**_action mode:_** announces when someone enters or leaves the room; **_action mode:_** announces when someone enters or leaves the room
**_situation:_** finding non-verbal ways of communicating through presence and absence; making presence felt otherwise; **_situation:_** finding non-verbal ways of communicating through presence and absence, making presence felt otherwise
<br>
### Gather ### Gather
**_name:_** gather.py; **_name:_** gather.py
**_action mode:_** generates a shared language; it creates a collective document; **_action mode:_** generates a shared language; it creates a collective document
**_situation:_** a collective discursive setting that generates its own vocabulary; **_situation:_** a collective discursive setting that generates its own vocabulary
<br>
### Greet ### Greet
**_name:_** greet.py; **_name:_** greet.py
**_action mode:_** sends a message when it enters the room; **_action mode:_** sends a message when it enters the room
**_situation:_** when there is a theme, for example: "send a reference to an existing or imaginary code of conduct, complaint, guideline, bug report, open letter, license or other social-technical protocol and explain why it is of interest to you."; how one wants to be introduced; **_situation:_** when there is a theme, for example: "send a reference to an existing or imaginary code of conduct, complaint, guideline, bug report, open letter, license or other social-technical protocol and explain why it is of interest to you."; how one wants to be introduced
<br>
### Spark ### Spark
**_name:_** spark.py; **_name:_** spark.py
**_action mode:_** replies to a specific word; brings alternatives into the situation; tries to create new habits and terminologies; **_action mode:_** replies to a specific word; brings alternatives into the situation; tries to create new habits and terminologies
**_situation:_** potentially in moments when a situation seems difficult and there is a need for more joyful interactions; **_situation:_** potentially in moments when a situation seems difficult and there is a need for more joyful interactions
<br>
### Whisper ### Whisper
**_name:_** whisper.py **_name:_** whisper.py
**_action mode:_** takes what someone says to it in confidentiality and echoes it to a group chat, thus anonymising it; **_action mode:_** takes what someone says to it in confidentiality and echoes it to a group chat, thus anonymising it
**_situation:_** there are remarks or complaints in the room, but the person does not feel comfortable to bring up the issue themselves; **_situation:_** there are remarks or complaints in the room, but the person does not feel comfortable to bring up the issue themselves
<br>
## Installing and Running the Bots ## Installing and Running the Bots
@ -107,7 +95,7 @@ Some installation guides can be found under the following links.
**python3 + pip3**: **python3 + pip3**:
*For computers running **Windows OS** or **Mac OS***: For computers running **Windows OS** or **Mac OS**:
1. check what version of Python you have on your computer with `$ python --version` 1. check what version of Python you have on your computer with `$ python --version`
2. if you have python 2.x, try also the following, to be sure that you don't have python3 already: `$ python3 --version` 2. if you have python 2.x, try also the following, to be sure that you don't have python3 already: `$ python3 --version`
@ -119,9 +107,9 @@ Some installation guides can be found under the following links.
pip3 comes installed with python3. pip3 comes installed with python3.
You can check if it installed correctly by running: `$ pip3 --version` You can check if it installed correctly by running: `$ pip3 --version`
<br> -----
*For computers running **Linux OS*** For computers running **Linux OS**:
* open the terminal * open the terminal
* check which version of python you have: * check which version of python you have:
@ -135,33 +123,31 @@ You can check if it installed correctly by running: `$ pip3 --version`
This is the Python library we use to make the bots. You can install it by running: $ pip3 install slixmpp This is the Python library we use to make the bots. You can install it by running: $ pip3 install slixmpp
**run the bots!**:
* download the bots from this page
* go to the folder where you have installed them
* run the following commands in the terminal:
> pip3 install slixmpp requests
* to run a bot, you can copy paste the commands which are already mentioned in the bot file, but a general command looks like this:
> python3 bot.py -d -j administratorbot@conversejs.org -r botsofconduct@muc.vvvvvvaria.org -n bot -p testing
* where:
- j stands for JID (jabber id)
- r means room
- n stands for bot nickname
- o stands for for output
- . means here
**code editor**: **code editor**:
* if you dont have a code editor, we can suggest (among others) [Sublime Text](https://www.sublimetext.com/) * if you dont have a code editor, we can suggest (among others) [Sublime Text](https://www.sublimetext.com/)
* to install the conversations app on your phone, you could use either Conversations or [Quicksy](https://quicksy.im/) for Android phones (among others) * to install the conversations app on your phone, you could use either Conversations or [Quicksy](https://quicksy.im/) for Android phones (among others)
## Run the bots!
* download the bots from this page
* go to the folder where you have downloaded them
* run the following commands in the terminal:
`$ pip3 install slixmpp requests`
* to run a bot, you can copy paste the commands which are already mentioned in the bot file, but a general command looks like this:
`$ python3 bot.py -d -j administratorbot@conversejs.org -r botsofconduct@muc.vvvvvvaria.org -n bot -p testing`
* where:
`-j` stands for JID (jabber id) \
`-r` means room \
`-n` stands for bot nickname \
`-o` stands for for output \
`. ` means here \
## Footnotes ## Footnotes
**Link to references [pad](https://pad.vvvvvvaria.org/Bots_of_Conduct_References) — further references and materials assembled by Joana and Cristina - feel free to add your own!** **Link to references [pad](https://pad.vvvvvvaria.org/Bots_of_Conduct_References) — further references and materials assembled by Joana and Cristina - feel free to add your own!**
[^1]: Varia is not merely a collective, nor merely a space. Varia is an interdependent concatenation of both [^genealogy]: genealogy of bots
[^2]: genealogy of bots
* https://gitlab.com/relearn/relearn2017/blob/master/xmpp-bots/timekeeper-bot/timekeeper.py (Relearn 2017) * https://gitlab.com/relearn/relearn2017/blob/master/xmpp-bots/timekeeper-bot/timekeeper.py (Relearn 2017)
* https://gitlab.com/relearn/relearn2017/blob/master/xmpp-bots/collection-bot/collection-bot.py (Relearn 2017) * https://gitlab.com/relearn/relearn2017/blob/master/xmpp-bots/collection-bot/collection-bot.py (Relearn 2017)