mirror of https://github.com/microsoft/autogen.git
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:
parent
78ff883d24
commit
dd1ade816e
|
@ -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)
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Reference in New Issue