| name | uv-install-agentjet-swarm-server |
| description | Install AgentJet swarm server using the UV package manager. Handles virtual environment creation with Python 3.10, dependency installation with the verl training backbone, flash-attn compilation, and optional PyPI mirror for China users. |
| license | Complete terms in LICENSE.txt |
when the user only need to run agentjet client, and do not have to run models locally (e.g. user in their laptop), ONLY install AgentJet basic requirements is enough (pip install -e .).
see install-agentjet-client skill
Prerequisites Check
Check Python version requirement (3.10) and uv availability.
Verify user has uv installed:
uv --version
If uv is not installed, follow the uv installation guide.
Step 1: Clone the Repository
Clone the AgentJet repository from GitHub and navigate into the project directory:
git clone https://github.com/modelscope/AgentJet.git
cd AgentJet
Step 2: Create Virtual Environment
Create a new virtual environment with Python 3.10 using uv:
uv venv --python=3.10
source .venv/bin/activate
Step 3: Install Dependencies
Install AgentJet with the verl training backbone:
uv pip install -e .[verl]
For users in China (faster with Aliyun mirror):
uv pip install -i https://mirrors.aliyun.com/pypi/simple/ -e .[verl]
Step 4: Test GitHub Connection (Before flash-attn)
Before installing flash-attn, test your connection to GitHub:
curl -I https://github.com --connect-timeout 10
or
git ls-remote https://github.com/Dao-AILab/flash-attention.git
!!! danger "⚠️ CRITICAL: Unstable GitHub Connection Detected"
If the above command fails or times out, you will NOT be able to download pre-compiled flash-attn wheels from GitHub.
This means flash-attn will need to be **compiled from source**, which can take:
- **30+ minutes** on a fast machine
- **1-2+ hours** on slower machines
**RECOMMENDED**: Find a way to establish a stable GitHub connection before proceeding:
- Use a VPN or proxy
- Use GitHub mirrors if available in your region
- Wait for better network conditions
- Use a machine with better GitHub connectivity
If you cannot establish a stable connection and must proceed with compilation:
```bash
# Set to number of CPUs to speed up compilation
export MAX_JOBS=$(nproc)
```
Step 5: Install flash-attn
flash-attn must be installed after other dependencies:
uv pip install --verbose flash-attn --no-deps --no-build-isolation --no-cache
For users in China (faster with Aliyun mirror):
uv pip install -i https://mirrors.aliyun.com/pypi/simple/ --verbose flash-attn --no-deps --no-build-isolation --no-cache
!!! warning "flash-attn Installation Notes"
- flash-attn must be installed after other dependencies.
- If installation takes a long time, ensure a healthy connection to GitHub.
- To build faster, you can set: export MAX_JOBS=${N_CPU} (replace ${N_CPU} with number of CPUs).
Step 6: Verify Installation
Verify the installation by checking the AgentJet version:
python -c "import ajet; print(ajet.__version__)"
Next Steps
After successful installation:
- Quick Start: Run your first training command and explore examples
- Tune Your First Agent: Follow the step-by-step guide to build and train your own agent
