Skip to content
 
 

Repository files navigation

Kitchen Worlds with Retrieval-Augmented Generation

This project is a fork and an extension of the original Kitchen Worlds environment developed by the The Learning & Intelligent Systems Group @ MIT. For more information on the simulated environment, please see their repository as well as their project website.

Project Goal

This projects aims at investigating the possible adantages of providing TAMP-focused Large Language Models with additional, embodied commonsense knowledge through Retrieval-Augemented Generation (RAG). For this, it evaluates the following databases combined in the RAG4Robots repository:

  • Recipes from Recipe1M+1
  • How-To Articles from a WikiHow corpus2
  • Transcript of two tutorial videos on cutting fruits & vegetables34
  • Object-Location tuples from the CommonSense Knowledge Graph (CSKG)5

Installation

Please follow these installation instructions below which are roughly the same as the ones from the original repository. As an alternative, there is a dockerfile available.

  1. Clone the repo along with the submodules. It may take a few minutes.
git clone --recursive https://github.com/ag-sc/kitchen-worlds-rag.git
git submodule sync && git submodule update --init --recursive
  1. Install dependencies. It may take a dozen minutes.
conda env create -f environment.yml
conda activate kitchen
## sudo apt-get install graphviz graphviz-dev  ## on Ubuntu
  1. Build FastDownward, the task planner used by PDDLStream planner.
## sudo apt install cmake g++ git make python3  ## if not already installed
(cd pddlstream; ./downward/build.py)
  1. Build IK solvers (If using mobile manipulators; skip this if you're only using the floating gripper).
  • (If on Ubuntu, this one is better) TracIK for whole-body IK that solves for base, torso, and arm together

    sudo apt-get install libeigen3-dev liborocos-kdl-dev libkdl-parser-dev liburdfdom-dev libnlopt-dev libnlopt-cxx-dev swig
    pip install git+https://github.com/mjd3/tracikpy.git
  • IKFast solver for arm planning (the default IK), which needs to be compiled for each robot type. Here's example for PR2:

    ## sudo apt-get install python-dev
    (cd pybullet_planning/pybullet_tools/ikfast/pr2; python setup.py)

References

Please cite the original kitchen-world environment by using the following papers in your research:

@inproceedings{Yang2023SequenceBased,
  title = {Sequence-{{Based Plan Feasibility Prediction}} for {{Efficient Task}} and {{Motion Planning}}},
  booktitle = {Proc. of {{Robotics}}: {{Science}} and {{Systems}} ({{RSS}})},
  author = {Yang, Zhutian and Garrett, Caelan and {Lozano-P{\'e}rez}, Tom{\'a}s and Kaelbling, Leslie and Fox, Dieter},
  year = 2023,
  address = {Daegu, Republic of Korea},
  doi = {10.15607/RSS.2023.XIX.061}
}

@inproceedings{Yang2025Guiding,
  title = {Guiding {{Long-Horizon Task}} and {{Motion Planning}} with {{Vision Language Models}}},
  booktitle = {Proc. of the {{IEEE International Conference}} on {{Robotics}} and {{Automation}} ({{ICRA}})},
  author = {Yang, Zhutian and Garrett, Caelan and Fox, Dieter and {Lozano-P{\'e}rez}, Tom{\'a}s and Kaelbling, Leslie Pack},
  year = 2025,
  address = {Atlanta, USA}
}

If you use this version of the repository and its RAG-based features, please cite the following research:

TBA

Acknowledgements

In addition to the wonderful work provided by the creators of the original repository (Zhutian Yang, Tomas Lozano-Perez, Jiayuan Mao, Weiyu Liu), this project vendors pybullet-planning (MIT License, © 2019 Caelan Garrett & Zhutian Yang). See pybullet_planning/LICENSE for details.

Additionally, we acknowledge the use of the following data sources for our RAG system:

Footnotes

  1. J. Marín et al., ‘Recipe1M+: A Dataset for Learning Cross-Modal Embeddings for Cooking Recipes and Food Images’, IEEE Transactions on Pattern Analysis and Machine Intelligence, vol. 43, no. 1, pp. 187–203, Jan. 2021, doi: 10.1109/TPAMI.2019.2927476.

  2. L. Zhang, Q. Lyu, and C. Callison-Burch, ‘Reasoning about Goals, Steps, and Temporal Ordering with WikiHow’, in Proc. of the 2020 Conference on Empirical Methods in Natural Language Processing (EMNLP), Online: Association for Computational Linguistics, 2020, pp. 4630–4639. doi: 10.18653/v1/2020.emnlp-main.374.

  3. Epicurious, YouTube. How To Chop Every Vegetable | Method Mastery | Epicurious, (Jan. 31, 2020). [Online Video]. Available: https://youtu.be/p28wMbunulQ?si

  4. Epicurious, YouTube. How To Slice Every Fruit | Method Mastery | Epicurious, (Nov. 06, 2019). [Online Video]. Available: https://youtu.be/VjINuQX4hbM

  5. F. Ilievski, P. Szekely, and B. Zhang, ‘CSKG: The CommonSense Knowledge Graph’, in The Semantic Web, vol. 12731, R. Verborgh, K. Hose, H. Paulheim, P.-A. Champin, M. Maleshkova, O. Corcho, P. Ristoski, and M. Alam, Eds., Cham: Springer International Publishing, 2021, pp. 680–696. doi: 10.1007/978-3-030-77385-4_41.

About

An adaptation of a library of long-horizon TAMP problems in kitchen and household scenes focused on adding RAG-based LLMs

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages