A.U.R.A

A.U.R.A is a robotics project developed for Advanced Topics in Robotics (Project Everywhere). It provides an end-to-end stack for controlling a rover, running an API + web UI, and integrating AI, audio, and vision.

Repository layout

All Code lives under src/:

• src/api/ — FastAPI backend

  • REST endpoints for rover control, voice, and vision
  • serves a small web UI from src/api/static/ (frontend pages)

• src/ai/ — AI orchestration

  • agent/pipeline code and integrations used by the API (LLM tools, flows, etc.)

• src/audio/ — Audio I/O

  • microphone capture, speaker output, buffering and helpers used for voice features

• src/vision/ — Vision pipeline

  • camera/runtime helpers + inference utilities (e.g., YOLO/ONNX)

• src/rover/ — Rover control

  • drive loop, safety/deadman, command/state logic, transport layer (serial)

• src/embedded/ — Embedded / C firmware sources

  • C/C++ code and files used on the rover controller (ESP32 / rover firmware)

Other project assets live outside src/:

• assets/3d/ — 3D models used from printing the robot body
• docs/ — Project report and other documentation

Setup

1) Create environment and install

uv sync
uv pip install -e .

2. Environment variables

Copy the template and fill in the values you need:

cp .env.example .env

3. Run the app

uv run uvicorn api.main:app --host 0.0.0.0 --port 8000