openrandonaut / openrandonaut-bot

Open source implementation of Randonautica functionality, with a Telegram bot. (DEPRECATED! See PyRandonaut.)

NOTE: THIS PROJECT HAS BEEN DEPRECATED IN FAVOR OF THE PYTHON LIBRARY PYRANDONAUT, AND WILL NO LONGER BE MAINTAINED

OpenRandonaut

Open-source QRNG coordinate bot

I couldn't find any attempt at an open-source version of the Fatum Project bot, so I decided to try and make one myself.

The script uses quantumrandom to interface with the ANU Quantum Random Number Generator, where it gets a list of truly random numbers, converts them to coordinates and then uses SciPy to compute the gaussian kernel density estimate of those coordinates. As far as I have understood, this should be equivalent of an Attractor point in the Fatum bot/Randonautica. The script can be interacted with through a Telegram-bot (made using python-telegram-bot).

If you're unfamiliar with The Fatum Project and the concepts of Probability Blind-Spots and Quantum Randomness, I recommend reading fatum_theory.txt which shipped with the original Fatum bot. This video gives a lot of great background info too. If you have no idea what any of this is about, watch this video and/or read this article.

Contributions would be greatly appreciated!

To-do:

• Get coordinate generation working
• Get Telegram-bot working
• Make heatmap generation more stable
• Get people excited about the project!
• Turn the coordinate logic into a module for use in other projects? 🤔

Table of contents

• Introduction
• Examples
• Installation
• Getting started

Examples

A few images for your pleasure:

Telegram bot preview:	Kernel density estimate visualization:
[1]	[2]

Fig. 1: A very shitty GIF demonstrating the functionality of the Telegram bot.
Fig. 2: A visualization of how the Attractor coordinate is calculated. The blue dots are quantum random coordinates. The heat map shows the density of those coordinates. The darker, the denser. The red X marks the point with the highest density. Made using seaborn and this script (BETA!).

Installation

1. I you don't already have: Install Python. OpenRandonaut needs at least version 3.9 of Python to run.

2. Install poetry (OpenRandonaut uses it for package management):
   curl -sSL https://install.python-poetry.org/ | python3 -

3. Clone the repository:
   git clone https://github.com/openrandonaut/openrandonaut-bot.git

4. Go to the openrandonaut directory and run poetry install. This will install all dependencies.

Getting started

1. Test out the coordinate generation by editing openrandonaut.py and uncommenting the lines at the bottom of the file. Save it and run python openrandonaut.py

2. Test out the Telegram bot, by registering a new Telegram bot and putting your token in bot.py where it says

updater = Updater(token="TELEGRAM_TOKEN_HERE", use_context=True)

Then run python bot.py and try sharing your location with your new bot in the Telegram app. (see Fig. 1 in Examples)