Add Git LFS Note to AGS Readme (#5798)

<!-- Thank you for your contribution! Please review
https://microsoft.github.io/autogen/docs/Contribute before opening a
pull request. -->

<!-- Please add a reviewer to the assignee section when you create a PR.
If you don't have the access to it, we will shortly find a reviewer and
assign them to your PR. -->



## Why are these changes needed?

<!-- Please give a short summary of the change and the problem this
solves. -->

- AGS contains image files which are required for local build /dev
- These files are stored using git lfs which needs to be run before the
files are downloaded
- This PR adds a reminder to the AGS readme to run `git lfs checkout`
after installing git lfs to download the image files

## Related issue number

<!-- For example: "Closes #1234" -->

Close #3418

## Checks

- [ ] I've included any doc changes needed for
<https://microsoft.github.io/autogen/>. See
<https://github.com/microsoft/autogen/blob/main/CONTRIBUTING.md> to
build and test documentation locally.
- [ ] I've added tests (if relevant) corresponding to the changes
introduced in this PR.
- [ ] I've made sure all auto checks have passed.
This commit is contained in:
Victor Dibia 2025-03-03 12:39:25 -08:00 committed by GitHub
parent 78ff883d24
commit dd1ade816e
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 62 additions and 22 deletions

View File

@ -8,6 +8,12 @@ mkdir -p frontend/node_modules
# This prevents permission issues when installing packages # This prevents permission issues when installing packages
sudo chown vscode frontend/node_modules sudo chown vscode frontend/node_modules
# Initialize git-lfs and fetch/checkout LFS files
git lfs install
git lfs fetch --all
git lfs checkout
pip install --upgrade pip gunicorn pip install --upgrade pip gunicorn
# Install the AutoGen Studio project in editable mode (-e flag) # Install the AutoGen Studio project in editable mode (-e flag)

View File

@ -39,13 +39,47 @@ pip install -U autogenstudio
_Note: This approach requires some familiarity with building interfaces in React._ _Note: This approach requires some familiarity with building interfaces in React._
### Important: Git LFS Requirement
AutoGen Studio uses Git Large File Storage (LFS) for managing image and other large files. If you clone the repository without git-lfs, you'll encounter build errors related to image formats.
**Before cloning the repository:**
1. Install git-lfs:
```bash
# On Debian/Ubuntu
apt-get install git-lfs
# On macOS with Homebrew
brew install git-lfs
# On Windows with Chocolatey
choco install git-lfs
```
2. Set up git-lfs:
```bash
git lfs install
```
**If you've already cloned the repository:**
```bash
git lfs install
git lfs fetch --all
git lfs checkout # downloads all missing image files to the working directory
```
This setup is handled automatically if you use the dev container method of installation.
You have two options for installing from source: manually or using a dev container. You have two options for installing from source: manually or using a dev container.
#### A) Install from source manually #### A) Install from source manually
1. Ensure you have Python 3.10+ and Node.js (version above 14.15.0) installed. 1. Ensure you have Python 3.10+ and Node.js (version above 14.15.0) installed.
2. Clone the AutoGen Studio repository and install its Python dependencies using `pip install -e .` 2. Clone the AutoGen Studio repository and install its Python dependencies using `pip install -e .`
3. Navigate to the `python/packages/autogen-studio/frontend` directory, install the dependencies, and build the UI: 3. Navigate to the `python/packages/autogen-studio/frontend` directory, install the dependencies, and build the UI:
```bash ```bash
npm install -g gatsby-cli npm install -g gatsby-cli
@ -59,10 +93,10 @@ You have two options for installing from source: manually or using a dev contain
#### B) Install from source using a dev container #### B) Install from source using a dev container
1. Follow the [Dev Containers tutorial](https://code.visualstudio.com/docs/devcontainers/tutorial) to install VS Code, Docker and relevant extensions. 1. Follow the [Dev Containers tutorial](https://code.visualstudio.com/docs/devcontainers/tutorial) to install VS Code, Docker and relevant extensions.
2. Clone the AutoGen Studio repository. 2. Clone the AutoGen Studio repository.
3. Open `python/packages/autogen-studio/`in VS Code. Click the blue button in bottom the corner or press F1 and select _"Dev Containers: Reopen in Container"_. 3. Open `python/packages/autogen-studio/`in VS Code. Click the blue button in bottom the corner or press F1 and select _"Dev Containers: Reopen in Container"_.
4. Build the UI: 4. Build the UI:
```bash ```bash
cd frontend cd frontend