Contents

1 Description

The InterCom project [7] is a collection of Python modules [3]. Python has been ported to almost all the current OSs, including mobile devices. Among all available development environments, the prefered one is Linux, and more concretely, on Xubuntu 24.04 (Noble Numbat) [5], running natively (no virtualization), if possible (see How to install xubuntu). Alternatively, you can use any other Linux distribution, such as Debian or Arch, or even any other OS (OSX or Windows).

InterCom has been written in Python. You don’t need to master Python to follow this course, but it is convenient for you to rely on some Python programming tutorial, such as The Python Tutorial [2] if you realize that the language is a setback for you. If you need to start with Python from the beginning, an introduction to Python such as this workshop of YAPT [4] could also be helpful. See also ZetCode’s Python Tutorial, for example (Internet if full of Python manuals).

To run InterCom, the following alternatives (both) should work:

1. Use the Python interpreter shipped with your OS. If you are using the recommended xubuntu version, the Python interpreter provided by the OS is fine. In this case, use a virtual environment when working with InterCom. To do this, run:

      # Supposing that the ~/envs/ folder contains the virtual environments 
      python3 -m venv ~/envs/TM # Create the environment TM (only the first time) 
      source ~/envs/TM/bin/activate # Activate it (allways you run InterCom)

   And to deactivate the environment, run:

      deactivate

   This is the recommended alternative.

2. Use a specific version of Python installed in a virtual environment. In this case, follow this guide.

Finally, if you want to contribute to the InterCom project [7] you must understand the basics of Git [1] and GitHub¹ [8], and how to use the The GitHub (Work-)Flow and the Fork-and-Branch Git Workflow [6]. Be aware that to contribute to InterCom, an GitHub account is required. Please, follow this minimal Git guide. In the guide, you must consider that <organization_name> is Tecnologias-multimedia and that <repo_name> is intercom.

2 Resources