For developers contributing to the AG2 project, we offer a specialized Docker environment. This setup is designed to streamline the development process, ensuring that all contributors work within a consistent and well-equipped environment.

​
AG2 Developer Image (ag2_dev_img)

  • Purpose: The ag2_dev_img is tailored for contributors to the AG2 project. It includes a suite of tools and configurations that aid in the development and testing of new features or fixes.
  • Usage: This image is recommended for developers who intend to contribute code or documentation to AG2.
  • Forking the Project: It’s advisable to fork the AG2 GitHub project to your own repository. This allows you to make changes in a separate environment without affecting the main project.
  • Updating Dockerfile: Modify your copy of Dockerfile in the dev folder as needed for your development work.
  • Submitting Pull Requests: Once your changes are ready, submit a pull request from your branch to the upstream AG2 GitHub project for review and integration. For more details on contributing, see the AG2 Contributing page.

​
Building the Developer Docker Image

  • To build the developer Docker image (ag2_dev_img), use the following commands:

    docker build -f .devcontainer/dev/Dockerfile -t ag2_dev_img https://github.com/ag2ai/ag2.git#main

  • For building the developer image built from a specific Dockerfile in a branch other than main/master

    # clone the branch you want to work out of
git clone --branch {branch-name} https://github.com/ag2ai/ag2.git

# cd to your new directory
cd ag2

# build your Docker image
docker build -f .devcontainer/dev/Dockerfile -t autogen_dev-srv_img .

​
Using the Developer Docker Image

Once you have built the ag2_dev_img, you can run it using the standard Docker commands. This will place you inside the containerized development environment where you can run tests, develop code, and ensure everything is functioning as expected before submitting your contributions.

docker run -it -p 8081:3000 -v `pwd`/autogen-newcode:newstuff/ ag2_dev_img bash
  • Note that the pwd is shorthand for present working directory. Thus, any path after the pwd is relative to that. If you want a more verbose method you could remove the “pwd/autogen-newcode” and replace it with the full path to your directory
docker run -it -p 8081:3000 -v /home/AutoGenDeveloper/autogen-newcode:newstuff/ ag2_dev_img bash

​
Develop in Remote Container

If you use vscode, you can open the ag2 folder in a Container. We have provided the configuration in devcontainer. They can be used in GitHub codespace too. Developing AG2 in dev containers is recommended.

Contributing to AG2Documentation