Installation Overview
Install ArgentOS on macOS, Linux, or via Docker.
Recommended Install
npx argentos initThis installs the argent CLI, creates the state directory, and runs the setup wizard.
Platform Support
| Platform | Status | Notes |
|---|---|---|
| macOS (Apple Silicon) | Full support | Primary development platform |
| macOS (Intel) | Full support | |
| Linux (x86_64) | Full support | Ubuntu 22.04+ recommended |
| Linux (ARM64) | Full support | Raspberry Pi 4+, Oracle ARM |
| Windows (WSL2) | Supported | Run inside WSL2 Ubuntu |
| Docker | Supported | See Docker guide |
Requirements
- Node.js 22+ — Use nvm, not system/Homebrew node
- pnpm — Package manager (installed automatically)
- 512MB RAM minimum (2GB+ recommended for local models)