Get started with the production-ready AI agent runtime
For Ubuntu, Debian, Fedora, Arch, and other distributions
For Windows 10/11 (64-bit)
Clone from GitHub for the latest development version
Follow these steps to install AgentOS on your system
Download the tar.gz file and extract it:
wget https://github.com/agents-os/agentos/releases/download/v1.0.0/agentos-1.0.0.tar.gz
tar -xzf agentos-1.0.0.tar.gz
cd agentos-1.0.0Execute the Linux installer script:
python3 install_linux.pySet up your API keys:
cp .env.example .env
nano .env # Add your API keysTest that AgentOS is working:
agentos --version
agentos chat --provider ollama # Test without API keyDownload the zip file and extract it to your preferred location.
Invoke-WebRequest -Uri "https://github.com/agents-os/agentos/releases/download/v1.0.0/agentos-1.0.0.zip" -OutFile "agentos.zip"
Expand-Archive -Path agentos.zip -DestinationPath .
cd agentos-1.0.0Execute the Windows installer script:
python install_windows.pySet up your API keys:
copy .env.example .env
notepad .env # Add your API keysTest that AgentOS is working:
agentos --versionGet the latest source code from GitHub:
git clone https://github.com/agents-os/agentos.git
cd agentosSet up an isolated Python environment:
python -m venv .venv
source .venv/bin/activate # Linux/Mac
# .venv\Scripts\activate # WindowsInstall required Python packages:
pip install -r requirements.txtSet up environment and start using AgentOS:
cp .env.example .env
# Edit .env with your API keys
python agentos.py --helpDownload previous versions of AgentOS
Make sure your system meets these requirements