Using a Codespace

To build and run the PizzaBot agent during this Open Hack, you can use a pre-configured GitHub Codespaces development environment.

This setup ensures:

• Python 3.13 is ready to go
• All required dependencies are pre-installed
• GitHub Copilot is enabled
• You can start coding right away in a consistent environment

Steps

1. Fork the Repository

1. Go to the official workshop repo:
   👉 https://github.com/microsoft/open-hack-agents-codespace
2. Click Fork in the top right corner.
3. Select your GitHub account as the destination.

This creates your own copy of the repo.

2. Start a Codespace

1. In your forked repository, click the green Code button.
2. Select the Codespaces tab.
3. Click Create codespace on main.

GitHub will now start a new Codespace using the provided devcontainer configuration.
This will:

• Build a container with Python 3.13
• Create a virtual environment (.venv)
• Install all dependencies from requirements.txt

This step can take a few minutes the first time.

3. Open the Workshop Directory

When your Codespace starts, make sure you’re working inside the myagent/ directory:

cd myagent

All your Python files (agent.py, tools.py, etc.) should be created and run from here.

4. Verify Your Environment

Run the following to check that everything is set up correctly:

python --version

Expected output: Python 3.13.x

pip list | grep azure

Expected output: Installed packages like azure-identity, azure-ai-projects, azure-ai-agents.

5. Start Coding 🚀

From here, start with challenge.

Recap

In this setup section, you have:

• Forked the workshop repo into your GitHub account
• Started a GitHub Codespace with the provided devcontainer
• Ensured Python 3.10 and dependencies are installed
• Opened the myagent/ directory as your working folder

You’re now ready to build the PizzaBot agent step by step. 🍕🤖