Go to file
Romain J 3525b9aa4b fix(commands:iplocalise|Network): remove crashing regex 2021-03-26 18:41:21 +01:00
.envs/.local feat(host): start docker addon 2021-02-11 23:18:12 +01:00
.github update(main): improve launch UI 2020-08-28 01:06:57 +02:00
.idea feat(commands:ralgo|Crypto): add ralgo api 2021-02-24 00:53:05 +01:00
compose fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00
tuxbot fix(commands:iplocalise|Network): remove crashing regex 2021-03-26 18:41:21 +01:00
.deepsource.toml fix(deepsource): remove black from deepsource conf 2020-10-21 00:02:02 +02:00
.gitignore fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00
.mypy.ini fix(commands:iplocalise|Network): remove crashing regex 2021-03-26 18:41:21 +01:00
.pylintrc fix(commands|Utils>source): stupid of me, the +3 was 'cause of a diff in local and github 2020-11-11 01:29:53 +01:00
LICENSE fix(linting): set the not to 10/10 on pylint 2020-10-19 00:20:58 +02:00
Makefile fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00
README.rst fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00
dev.requirements.txt fix(commands:iplocalise|Network): remove crashing regex 2021-03-26 18:41:21 +01:00
local.yml fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00
production.yml fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00
setup.cfg feat(commands:ralgo|Crypto): add ralgo api 2021-02-24 00:53:05 +01:00
setup.py fix(commands|Custom>alias): close TUXBOT-BOT-1A, close TUXBOT-BOT-1H, close TUXBOT-BOT-1J 2021-02-16 19:28:30 +01:00

README.rst

|image0| |image1| |image2| |image3|

.. role:: bash(code)
   :language: bash

Installing Tuxbot
=================

It is preferable to install the bot on a dedicated user. If you don't
know how to do it, please refer to `this guide <https://www.digitalocean.com/community/tutorials/how-to-create-a-sudo-user-on-ubuntu-quickstart>`__

Installing the pre-requirements
-------------------------------

-  The pre-requirements are:

   -  Python 3.9 or greater
   -  Pip
   -  Git

Operating systems
~~~~~~~~~~~~~~~~~

Arch Linux
^^^^^^^^^^

.. code-block:: bash

    $ sudo pacman -Syu python python-pip python-virtualenv git make gcc postgresql

Continue to `configure postgresql <#configure-postgresql>`__.

--------------

Debian
^^^^^^

.. code-block:: bash

    $ sudo apt update
    $ sudo apt -y install python3 python3-dev python3-pip python3-venv git make gcc postgresql postgresql-client

Continue to `configure postgresql <#configure-postgresql>`__.

--------------

RHEL and derivatives (CentOS, Fedora...)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: bash

    $ sudo dnf update
    $ sudo dnf install python3 python3-devel python3-pip python3-virtualenv git make gcc postgresql-server postgresql-contrib

Continue to `configure postgresql <#configure-postgresql>`__.

--------------

Windows
^^^^^^^

*not for now and not for the future*

--------------

Configure PostgreSQL
--------------------

Now, you need to setup PostgreSQL

Operating systems
~~~~~~~~~~~~~~~~~

Arch Linux
^^^^^^^^^^

https://wiki.archlinux.org/index.php/PostgreSQL

Continue to `create the venv <#creating-the-virtual-environment>`__.

--------------

Debian
^^^^^^

https://wiki.debian.org/PostgreSql

Continue to `create the venv <#creating-the-virtual-environment>`__.

--------------

RHEL and derivatives (CentOS, Fedora...)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

https://fedoraproject.org/wiki/PostgreSQL

Continue to `create the venv <#creating-the-virtual-environment>`__.

--------------

Creating the Virtual Environment
--------------------------------

To set up the virtual environment and install the bot, simply run this
two commands:

.. code-block:: bash

    $ make
    $ make install

Now, switch your environment to the virtual one by run this single
command: :bash:`source ~/venv/bin/activate`

Configuration
-------------

It's time to set up your first instance, to do this, you can simply
execute this command:

:bash:`tuxbot-setup [your instance name]`

After following the instructions, you can run your instance by executing
this command:

:bash:`tuxbot [your instance name]`

Update
------

To update the whole bot after a :bash:`git pull`, just execute

.. code-block:: bash

    $ make update

.. |image0| image:: https://img.shields.io/badge/python-3.9%20%7C%203.10-%23007ec6
.. |image1| image:: https://img.shields.io/github/issues/Rom1-J/tuxbot-bot
.. |image2| image:: https://img.shields.io/badge/code%20style-black-000000.svg
.. |image3| image:: https://wakatime.com/badge/github/Rom1-J/tuxbot-bot.svg
    :target: https://wakatime.com/badge/github/Rom1-J/tuxbot-bot