A crowdsourced phrasebook for robots that read ChatGPT
This repo crowdsources the prompt spells that let ChatGPT command drones, robot arms, and simulators.

What it does
PromptCraft-Robotics is a community archive and a testbed for using large language models to direct robots. It hosts curated prompt examples—submitted via GitHub Discussions and voted on by the community—for tasks like aerial inspection, object manipulation, and visual navigation. The repository also bundles a ready-made AirSim simulator environment where a drone takes natural-language commands relayed through ChatGPT.
The interesting bit
The project treats prompt engineering as a communal, empirical science for physical systems rather than a solo hack. Instead of hiding failed attempts, it explicitly welcomes “incorrect” or suboptimal prompts if they reveal something interesting about how LLMs reason—or fail to reason—about physics and spatial relationships. It is essentially a shared lab notebook for robot hallucinations.
Key highlights
- Community-driven prompt curation via
GitHub Discussionswith upvoting and admin review. - Covers both simulated (
AirSim, Habitat) and real-world hardware (Tello drone, physical manipulation arms). - Includes a downloadable
AirSimbinary with pre-built inspection scenes (turbines, solar panels, towers) and aChatGPT-linked drone interface. - Backed by a Microsoft Research technical report on design principles and model abilities.
- Prompts span categories from embodied navigation to spatial-temporal reasoning (e.g., visual servoing with a basketball).
Caveats
- Heavily tilted toward OpenAI’s
ChatGPT; support for other LLMs is explicitly welcome but still nascent. - The bundled
AirSimenvironment is distributed as a binary, which suggests limited ability to modify underlying simulation assets.
Verdict
Robotics researchers and prompt engineers who want to see how LLMs translate prose into trajectories will find the curated examples and simulator useful. If you are looking for a drop-in, model-agnostic robot control framework with no API dependencies, this is not it.
Frequently asked
- What is microsoft/PromptCraft-Robotics?
- This repo crowdsources the prompt spells that let ChatGPT command drones, robot arms, and simulators.
- Is PromptCraft-Robotics open source?
- Yes — microsoft/PromptCraft-Robotics is open source, released under the MIT license.
- What language is PromptCraft-Robotics written in?
- microsoft/PromptCraft-Robotics is primarily written in Python.
- How popular is PromptCraft-Robotics?
- microsoft/PromptCraft-Robotics has 2.1k stars on GitHub.
- Where can I find PromptCraft-Robotics?
- microsoft/PromptCraft-Robotics is on GitHub at https://github.com/microsoft/PromptCraft-Robotics.