Project Robo is a Python-based 2D robot football simulator inspired by RoboCup Small Size League, featuring manual fixed-timestep physics, keyboard controls, match states, logging, and modular controller/sensor APIs, currently containing only the simulation layer.

Stars

4

7-day growth

No data

Forks

0

Open issues

0

License

No data

Last updated

2026-07-31

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It offers a production-quality, engine-free simulation foundation with clean separation between physics, rendering, entities, and controllers, deliberately designed so future AI, vision, path planning, and reinforcement learning modules can be added without rewriting the simulator.

Who it is for

  • RoboCup SSL researchers and robot soccer simulator developers
  • AI and reinforcement learning practitioners who need a clean simulation environment to build agents
  • Robotics students learning 2D physics, collision handling, and controller design
  • Hobbyists and researchers interested in modular Python simulation architecture

Use cases

  • Prototyping control algorithms through the abstract controller API before adding autonomy
  • Building a foundation for computer vision, state estimation, path planning, and decision-making modules
  • Generating CSV/JSON logs of full robot and ball states for analysis or plotting
  • Using the keyboard-driven simulator as a manual testbed for physics tuning and match-flow logic

Strengths

  • Fixed-timestep manual physics with friction, wall bounce, robot-ball collision, and robot-robot collision
  • Modular architecture separating game loop, physics, renderer, entities, controllers, and logging
  • Renderer-independent sensor API and abstract controller API simplify future AI integration
  • Built-in event manager, match state machine, HUD, frame CSV/JSON export, and unit tests

Considerations

  • Machine learning, reinforcement learning, path planning, tactical decision making, and computer vision are intentionally not implemented yet
  • The repository currently contains only the simulation layer, with no real robot or vision integration
  • Gameplay is keyboard-first with human/dummy controllers, so autonomous play requires implementing new controllers and AI modules

README quick start

Installation

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
jamesob
Featured
jamesob GitHub avatar

local-llm

A comprehensive guide for building and configuring a high-end local machine to run state-of-the-art LLMs, with detailed hardware choices, BIOS tuning, and Docker-based model serving.

AI & Machine LearningLarge Language Models
1,660