K-Agent框架学习实验室

# Clone the repository
git clone https://github.com/CodeWizard-IL/Kagent.git
cd Kagent/

# Build and start the labs environment
cd labs-environment
export TARGET_PLATFORM=$(uname -m | sed 's/x86_64/linux\/amd64/g' | sed 's/arm64/linux\/arm64/g')
echo "TARGET_PLATFORM=$TARGET_PLATFORM" > .env
echo "ROOT_FOLDER=$(pwd)/.." >> .env
docker compose up -d

# Start with Lab 000
cd ../Labs/000-setup
bash _demo.sh

/
├── Labs/                      # Lab markdown files and exercises
│   ├── 000-setup/
│   ├── 001-mcp-basics/
│   ├── 002-python-server/
│   ├── 003-typescript-server/
│   └── ...
├── labs-environment/          # Unified Docker environment
│   ├── Dockerfile
│   ├── docker-compose.yaml
│   ├── entrypoint.sh
│   └── src/                   # Sample MCP server code
├── _utils/                    # Utility scripts
│   ├── common.sh              # Shared functions
│   └── init-cluster.sh        # Cluster initialization
├── mkdocs/                    # MKdocs configuration
│   ├── 01-mkdocs-site.yml
│   ├── 02-mkdocs-theme.yml
│   ├── ...
│   ├── requirements.txt
│   └── scripts/
│       └── init_site.sh       # Site build script
├── .github/workflows/         # CI/CD workflows
│   ├── 000-setup.yaml
│   ├── ...
│   └── deploy-mkdocs.yml
└── runtime/                   # Generated at runtime
    ├── labs-scripts/
    ├── .ssh/
    └── .kube/

cd 

# Build and serve
chmod +x mkdocs/scripts/init_site.sh
bash mkdocs/scripts/init_site.sh --serve

# Or manually with Python
python3 -m venv .venv
source .venv/bin/activate
pip install -r mkdocs/requirements.txt
mkdocs serve

# Start the labs environment
cd labs-environment
docker compose up -d

# Connect to the container
docker exec -it kagent-controller bash

# Inside the container, navigate to lab exercises
cd /labs-scripts

# Run a specific lab
cd Labs/001-mcp-basics
bash _demo.sh