Skip to content

B-AROL-O/RAMIE-RAD_AI_Messing_In_Earthworks

Repository files navigation

title emoji colorFrom colorTo sdk sdk_version app_file pinned license short_description tags
RAMIE-RAD AI Messing In Earthworks
🐨
gray
pink
gradio
5.49.1
app.py
false
cc-by-sa-4.0
A local Gradio MCP server controlling a robot platform
mcp-in-action-track-creative

RAMIE

  • Radical
  • AI
  • Messing
  • In
  • Earthworks

A local Gradio MCP AI powered wheeled robot, capable of listening, speaking and executing commands, in the vision of the B-AROL-O team

TRIVIA: The B-AROL-O team likes to use names of Italian wines as acronyms for robots. RAMIE is a local red wine from my village

TRIVIA: "Vino" is the Italian word for Wine. Intel OpenVINO AI runtime is the perfect runtime to run a robot named after an italian wine by italian developers

Scope

The scope of this repository is to document the Hugging Face MCP 1° birthday hackaton

The scope of this repository is to document all instruction to replicate in full the robot project

Work is divided in two parts:

  • Work that is qualifying for the hackaton itself, that was started 2025-11-14, this includes learning GRADIO, learning MPC, preparing the MCP tools, interfacing ollama with AI models needed

  • Work that is not qualifying for the hackaton and was recycled from previous projects and is in this repository in order to make a complete set of instructions to replicate this project. This include the electronics, the mechanical part of the robot, learning the compute board, and learning that was done for ollama testing of the microphone

This felt like a good chance to gather all the disparate documentation and work done over the years in one tidy set of insttructions that can be followed to make one complete platform end to end with the GRADIO/MCP/OLLAMA software being the keystone that glue it all together.

Documentation

Designs marked with '(not qualifying for hackaton) ' are older recycled design that are here for documentation, instruction and completeness purposes and are not qualifying for the scope of the hackaton. They are either taken as is, or lightly/heavily adapted to serve for the scope of the Hackaton.

Mechanical Design

I design in OpenSCAD as I like making geometries as code and I like doing everything parametric.

I decided that the robots should be powered by 18650 batteries. Target configuration is 2S2P. For RAMIE I went with an inverted design that is soldered 4S1P to get 14.8V nominal voltage to be compatible with the input regulator for the Latte Panda Lite Board.

The robot platform is the one I am designing for Latte Panda Lite Board powered AI robots, it was a good fit for this hackaton

Board Motor Screen

Interfaces with a UART bidirectional link with the SBC, answer to a serial protocol, controls two servos and a LCD screen. Choosen because I had a bounch assembled in a drawer and working firmware to start from.

SBC Latte Panda Mu N100 16GB

I lost count of the SBCs I tested for my ultimate goal of making a general robot that expresses a degree of general intelligence with local compute only. The N100 16GB could be it, it has the memory, bandwidth, compute and power envelope to run useful LLMs on the go.

Luckfox PicoKVM

I always have trouble accessing SBC headless, I finally got a 49€ KVM to mitigate the issue and free myself from using discrete keyboard and mouse

Luckfox PicoKVM Instructions

INSTALL UBUNTU

Install Ubuntu 24.04 Server LTS on the SBC and configure network and storage

Ubuntu 24.04 Server Install Instructions

Luckfox PicoKVM

I always have trouble accessing SBC headless, I finally got a 49€ KVM to mitigate the issue and free myself from using discrete keyboard and mouse

Luckfox PicoKVM Instructions

TTYS0 SSH PUTTY SERIAL

Configure the GRUB to use ttyS0 as UART serial interface to let the host connect via putty via USB to UART FTDI adapter

TTYS0 SERIAL GRUB CONFIGURATION

VS Code Remote

Use VS code on host machine with remote SSH plugin to evelop and run code directly on the SBC via WiFi radio

VS Code Remote Instructions

Battery Teleoperation SSH WiFI

Final test with the robot under battery power with SBC, AT324, WiFI and motors running with SSH teleoperation form keyboard

2025-11-23-T1537.Teleoperation.SSH.Demo.mp4

Ollama GRADIO LLamaindex

The robot hosts and run locally GRADIO

There are two chats

One is the chat to ask about RAMIE capability using LLamaindex to rag the specifications

The second has a tool that attaches with a MCP tool to the motors and genereate serial command for the robot to execute

Contributors

Useful Links

TRACK

Track 2: MCP in Action

mcp-in-action-track-creative

Copyright and License

Copyright (C) 2025, B-AROL-O Team, all rights reserved.

NOTE: This repository is based upon https://github.com/arol-polito/python-project-template. Source code license

The source code contained in this repository and the executable distributions are licensed under the terms of the MIT license as detailed in the LICENSE file. Documentation license

CC BY-SA 4.0

Please note that your contribution to the project Documentation is licensed under a Creative Commons Attribution-Share Alike 4.0 License. see https://creativecommons.org/licenses/by-sa/4.0/

About

A local Gradio MCP server controlling a robot platform

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •