Skip to main content

​
Prerequisites (macOS)

ArgentOS uses Homebrew to install PostgreSQL, Redis, and system services. Install it first if you don’t have it: 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

​
One-Command Install

curl -fsSL https://argentos.ai/install.sh | bash
Need to test a release candidate before it is promoted to main? Use the Developer Branch install guide. On macOS, this installs the full native stack:
ComponentWhat it doesPort
HomebrewRequired — must be pre-installed (see above)—
PostgreSQL 17Memory, knowledge, agent registry5433
RedisState, pub/sub, inter-agent streams6380
Node.js 22Runtime (via nvm)—
ArgentOSAgent source, CLI, built dist—
GatewayBackground LaunchAgent (survives reboots)18789
Argent.appmacOS desktop app with onboarding wizard—
Non-default ports (5433, 6380) are used to avoid conflicts with existing PostgreSQL or Redis installations.

​
Platform Support

PlatformStatusInstall method
macOS (Apple Silicon)Full supportcurl installer — primary platform
macOS (Intel)Full supportcurl installer
Linux (x86_64)Supportedcurl installer (no .app, CLI only)
Linux (ARM64)Supportedcurl installer (Raspberry Pi 4+, Oracle ARM)
Windows (WSL2)SupportedRun installer inside WSL2 Ubuntu
DockerSupportedSee Docker guide

​
Requirements

  • macOS 13+ or Ubuntu 22.04+ (or equivalent)
  • 4GB RAM minimum (8GB+ recommended for local models)
  • Anthropic API key or Max subscription setup token — for the agent runtime
  • Internet connection for initial install
Node.js 22 and pnpm are installed automatically by the installer. If you already have Node via nvm, it will be detected and reused.

​
What Gets Installed

The installer creates these paths:
PathContents
~/.argentos/Config, memory database, agent state, logs
~/.argentos/runtime/Private Node.js runtime (if nvm not available)
~/argentos/Source checkout (git clone)
~/bin/argentCLI wrapper
/Applications/Argent.appmacOS desktop app (macOS only)
~/Library/LaunchAgents/ai.argent.*Gateway and Redis LaunchAgents (macOS only)

​
Manual Install (from source)

If you prefer to install manually:
1

Clone the repository

git clone --depth 1 https://github.com/ArgentAIOS/argentos.git ~/argentos
cd ~/argentos
2

Install dependencies and build

pnpm install
pnpm build
3

Link the CLI

mkdir -p ~/bin
ln -sf ~/argentos/scripts/run-node.sh ~/bin/argent
4

Run setup and start the gateway

argent setup
argent gateway install
argent gateway start
You’ll need to install PostgreSQL 17 (port 5433) and Redis (port 6380) yourself. See the setup scripts in scripts/setup-postgres.sh and scripts/setup-redis.sh.

​
Verify Installation

argent gateway status
You should see the gateway running and healthy. If something went wrong, see Troubleshooting.

​
Next Steps

Complete onboarding

Connect your first channel.

Uninstall

Clean removal of all services.

Updating

Keep ArgentOS current.

Developer Branch

Install from the private develop lane for regression testing.

Docker

Containerized deployment.