Skip to main content

​
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 first if you don’t have it: 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Then install ArgentOS: 
curl -fsSL https://argentos.ai/install.sh | bash
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)
Requirements: macOS (Apple Silicon or Intel). Linux support is available — see Installation for details.

​
First Run

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

Auth

Connect your Anthropic API key or Max subscription setup token.
2

Identity

Name your agent, set personality and voice.
3

Channels

Connect Telegram, Discord, Slack, or WhatsApp.
4

Workspace

Configure where your agent stores files.
If you prefer the CLI: 
argent setup

​
Connect a Channel

Give your agent a way to reach you: 
argent channels add telegram
Telegram, Discord, Slack, and WhatsApp are fully supported. Follow the prompts — you’ll be connected in under a minute. See the Channels guide for platform-specific setup.

​
Talk to Your Agent

Open the dashboard: 
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:

Memory

Your agent remembers conversations, facts, and preferences automatically. Try asking it what it knows about you after a few chats.

Tasks

Assign work. Your agent tracks priorities, dependencies, and progress.

Alignment Docs

Shape your agent’s personality, values, and communication style through editable identity documents.

Knowledge Library

Feed it PDFs, docs, and spreadsheets. It chunks, embeds, and searches them for you.

Model Routing

ArgentOS picks the right model for each task — from free local models to Opus — so you don’t burn tokens on simple questions.

Contemplation

Your agent thinks on its own when idle. It journals, reflects, and develops over time.
Welcome to ArgentOS. It only gets better from here.