| name | conda-install-agentjet-swarm-server |
| description | Install AgentJet swarm server using Conda. Handles Python 3.10 environment creation, 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 conda availability.
Verify user has conda installed:
conda --version
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 Conda Environment
Create a new conda environment with Python 3.10:
conda create -n ajet-verl python=3.10
conda activate ajet-verl
Step 3: Install Dependencies
Default Installation
Install AgentJet with the verl training backbone:
pip install -e .[verl]
For Users in China
Use Aliyun PyPI mirror for faster downloads:
pip install -i https://mirrors.aliyun.com/pypi/simple/ -e .[verl]
Step 4: Test GitHub Connection
Before installing flash-attn, test the connection to GitHub:
curl -I --connect-timeout 10 https://github.com 2>/dev/null | head -n 1
If the connection test fails or times out:
!!! danger "IMPORTANT: GitHub Connection Issue Detected"
⚠️ WARNING: You cannot connect to GitHub stably!
flash-attn requires downloading pre-compiled wheels from GitHub. Without a stable GitHub connection, pip will attempt to build flash-attn from source, which can take **30 minutes to several hours**.
**Recommended actions:**
1. Set up a stable connection to GitHub (VPN, proxy, etc.)
2. Use a mirror that hosts flash-attn pre-compiled wheels
3. If you must proceed, set `MAX_JOBS` to limit CPU usage during build:
```bash
export MAX_JOBS=4 # Adjust based on your CPU cores
```
**Do you want to proceed anyway?** (This may take a very long time)
Step 5: Install flash-attn
flash-attn must be installed after other dependencies:
Default Installation
pip install --verbose flash-attn --no-deps --no-build-isolation --no-cache
For Users in China
pip install -i https://mirrors.aliyun.com/pypi/simple/ --verbose flash-attn --no-deps --no-build-isolation --no-cache
!!! warning "flash-attn Installation"
- flash-attn must be installed after other dependencies.
- Ensure a healthy connection to GitHub to install pre-compiled wheels.
- If you find your machine spend a long time installing flash-attn, ensure a healthy connection to GitHub.
- To build faster, export MAX_JOBS=${N_CPU}.
Verification
Verify the installation:
python -c "import ajet; print(ajet.__version__)"
