> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install ArgentOS on macOS, Linux, or via Docker.

## Prerequisites (macOS)

ArgentOS uses Homebrew to install PostgreSQL, Redis, and system services. Install it first if you don't have it:

```bash theme={null}
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

## One-Command Install

```bash theme={null}
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](/install/developer-branch).

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     | —     |

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

## 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](/install/docker)            |

## 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

<Tip>
  Node.js 22 and pnpm are installed automatically by the installer. If you already have Node via nvm, it will be detected and reused.
</Tip>

## 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:

<Steps>
  <Step title="Clone the repository">
    ```bash theme={null}
    git clone --depth 1 https://github.com/ArgentAIOS/argentos.git ~/argentos
    cd ~/argentos
    ```
  </Step>

  <Step title="Install dependencies and build">
    ```bash theme={null}
    pnpm install
    pnpm build
    ```
  </Step>

  <Step title="Link the CLI">
    ```bash theme={null}
    mkdir -p ~/bin
    ln -sf ~/argentos/scripts/run-node.sh ~/bin/argent
    ```
  </Step>

  <Step title="Run setup and start the gateway">
    ```bash theme={null}
    argent setup
    argent gateway install
    argent gateway start
    ```
  </Step>
</Steps>

<Warning>
  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`.
</Warning>

## Verify Installation

```bash theme={null}
argent gateway status
```

You should see the gateway running and healthy. If something went wrong, see [Troubleshooting](/help/troubleshooting).

## Next Steps

<CardGroup cols={2}>
  <Card title="Complete onboarding" icon="flag-checkered" href="/start/onboarding">
    Connect your first channel.
  </Card>

  <Card title="Uninstall" icon="trash-can" href="/install/uninstall">
    Clean removal of all services.
  </Card>

  <Card title="Updating" icon="arrows-rotate" href="/install/updating">
    Keep ArgentOS current.
  </Card>

  <Card title="Developer Branch" icon="flask" href="/install/developer-branch">
    Install from the private `develop` lane for regression testing.
  </Card>

  <Card title="Docker" icon="docker" href="/install/docker">
    Containerized deployment.
  </Card>
</CardGroup>