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

# Getting Started

> Install ArgentOS and talk to your personal AI in under 5 minutes.

## Your AI, running on your machine

ArgentOS is a personal AI operating system. It runs locally, remembers everything, and connects to the channels you already use. No cloud accounts to manage. No vendor lock-in. Just your agent, working for you.

## Install

**Prerequisite (macOS):** Install [Homebrew](https://brew.sh) first if you don't have it:

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

Then install ArgentOS:

```bash theme={null}
curl -fsSL https://argentos.ai/install.sh | bash
```

<Info>
  The installer handles everything after Homebrew:

  * **Homebrew** — required, must be pre-installed
  * **PostgreSQL 17** on port 5433 (non-default to avoid conflicts)
  * **Redis** on port 6380 (non-default to avoid conflicts)
  * **Node.js 22** via nvm (if not already present)
  * **ArgentOS source** cloned, built, and CLI linked
  * **Gateway** installed as a LaunchAgent (stays on across reboots)
  * **Argent.app** downloaded and launched (macOS)
</Info>

**Requirements:** macOS (Apple Silicon or Intel). Linux support is available — see [Installation](/install) for details.

## First Run

The Argent.app opens automatically after install. The onboarding wizard walks you through:

<Steps>
  <Step title="Auth">
    Connect your Anthropic API key or Max subscription setup token.
  </Step>

  <Step title="Identity">
    Name your agent, set personality and voice.
  </Step>

  <Step title="Channels">
    Connect Telegram, Discord, Slack, or WhatsApp.
  </Step>

  <Step title="Workspace">
    Configure where your agent stores files.
  </Step>
</Steps>

If you prefer the CLI:

```bash theme={null}
argent setup
```

## Connect a Channel

Give your agent a way to reach you:

```bash theme={null}
argent channels add telegram
```

<Tip>
  Telegram, Discord, Slack, and WhatsApp are fully supported. Follow the prompts — you'll be connected in under a minute. See the [Channels guide](/channels) for platform-specific setup.
</Tip>

## Talk to Your Agent

Open the dashboard:

```bash theme={null}
argent dashboard
```

This launches the web UI at `http://localhost:8080`. Say hello. Ask it to remember something. Give it a task. Your agent has memory, personality, and tools — it's not a stateless chatbot.

Or just message it on the channel you connected. It's the same agent everywhere.

## What to Try Next

You're up and running. Here's where it gets interesting:

<CardGroup cols={2}>
  <Card title="Memory" icon="brain" href="/memory">
    Your agent remembers conversations, facts, and preferences automatically. Try asking it what it knows about you after a few chats.
  </Card>

  <Card title="Tasks" icon="list-check" href="/tasks">
    Assign work. Your agent tracks priorities, dependencies, and progress.
  </Card>

  <Card title="Alignment Docs" icon="file-lines" href="/agents/alignment-docs">
    Shape your agent's personality, values, and communication style through editable identity documents.
  </Card>

  <Card title="Knowledge Library" icon="book" href="/agents/knowledge-library">
    Feed it PDFs, docs, and spreadsheets. It chunks, embeds, and searches them for you.
  </Card>

  <Card title="Model Routing" icon="route" href="/models">
    ArgentOS picks the right model for each task — from free local models to Opus — so you don't burn tokens on simple questions.
  </Card>

  <Card title="Contemplation" icon="thought-bubble" href="/agents/contemplation">
    Your agent thinks on its own when idle. It journals, reflects, and develops over time.
  </Card>
</CardGroup>

Welcome to ArgentOS. It only gets better from here.