Installation

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:

Component	What it does	Port
Homebrew	Required — must be pre-installed (see above)	—
PostgreSQL 17	Memory, knowledge, agent registry	5433
Redis	State, pub/sub, inter-agent streams	6380
Node.js 22	Runtime (via nvm)	—
ArgentOS	Agent source, CLI, built dist	—
Gateway	Background LaunchAgent (survives reboots)	18789
Argent.app	macOS desktop app with onboarding wizard	—

Non-default ports (5433, 6380) are used to avoid conflicts with existing PostgreSQL or Redis installations.

Platform Support

Platform	Status	Install method
macOS (Apple Silicon)	Full support	`curl` installer — primary platform
macOS (Intel)	Full support	`curl` installer
Linux (x86_64)	Supported	`curl` installer (no .app, CLI only)
Linux (ARM64)	Supported	`curl` installer (Raspberry Pi 4+, Oracle ARM)
Windows (WSL2)	Supported	Run installer inside WSL2 Ubuntu
Docker	Supported	See 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:

Path	Contents
`~/.argentos/`	Config, memory database, agent state, logs
`~/.argentos/runtime/`	Private Node.js runtime (if nvm not available)
`~/argentos/`	Source checkout (git clone)
`~/bin/argent`	CLI wrapper
`/Applications/Argent.app`	macOS desktop app (macOS only)
`~/Library/LaunchAgents/ai.argent.*`	Gateway and Redis LaunchAgents (macOS only)

Manual Install (from source)

If you prefer to install manually:

Clone the repository

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

Install dependencies and build

pnpm install
pnpm build

Link the CLI

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

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.

Getting Started

Channels

Agents

Connectors

Tools

Concepts

Memory

Model Router

Installation

Prerequisites (macOS)

One-Command Install

Platform Support

Requirements

What Gets Installed

Manual Install (from source)

Verify Installation

Next Steps

Complete onboarding

Uninstall

Updating

Developer Branch

Docker

​Prerequisites (macOS)

​One-Command Install

​Platform Support

​Requirements

​What Gets Installed

​Manual Install (from source)

​Verify Installation

​Next Steps

Complete onboarding

Uninstall

Updating

Developer Branch

Docker

Prerequisites (macOS)

One-Command Install

Platform Support

Requirements

What Gets Installed

Manual Install (from source)

Verify Installation

Next Steps