village
Launching the TV Application
Before launching the software for the first time, it is highly recommended to update your repository to ensure you are running the latest stable version. Open a terminal window (press Ctrl + Alt + T or click the terminal icon in the taskbar next to the Raspberry Pi logo), navigate to the project directory, and pull the latest changes from GitHub by running:
cd village
git pull
Once the repository is up to date, you can launch the software by typing:
village
Behind the Scenes:
When you run the village command, the system automatically executes a shortcut script that handles the background environment setup. Specifically, it activates your Python virtual environment by running source ~/.env/bin/activate and then executes the core script located at /home/pi/village/village/main.py to start the program and display the GUI.
Default Project
The first time the Training Village (TV) is launched, a default project is automatically cloned from GitHub containing a repository with several example tasks.
This repository is named demo-village-project and is located at:
“https://github.com/BrainCircuitsBehaviorLab/demo-village-project.git”
Automatic Component Check
When the GUI launches, the system immediately performs an automated self-diagnostic check on all essential hardware connections (such as cameras, temperature sensors, scales, etc.). If a connection to a critical component cannot be established, a warning message will appear, and the Training Village will enter Debug Mode.
Note:
Upon your very first boot, you will likely receive warnings stating that telegram_bot and box_chip are not functioning. This is perfectly normal if you have not configured Telegram yet or if you haven’t connected the physical Box Board satallite module. You can safely ignore these specific warnings for now; they will not prevent the core system from running.