Skip to main content
This guide takes you from zero to your first agent session. If you want the mental model first, read Core concepts — otherwise, dive in.
1

Install the desktop app

Download Nuphos for macOS from nuphos.ai and open the app.
2

Sign in

Choose Continue with Google to sign in. The first time you sign in, Nuphos creates a team for you — the container that everything else lives in.
3

Connect a cloud account

Open Connectors and connect your first account. The agent needs at least one connected account to do anything useful.

Connect AWS

Assume an IAM role via OIDC.

Connect GCP

Impersonate a service account.
Both providers offer a guided setup where the agent runs your local CLI and does the work for you — that’s the fastest path.
4

Start an agent session

Open the Agent and start a new session. Select the account you just connected as the session’s credential, then describe what you want — for example:
“List the EKS clusters in this account and tell me if any nodes are unhealthy.”
The agent investigates using real tools and streams its progress. See Agent sessions.
5

Approve a change (when you're ready)

Ask the agent to change something and it won’t act blindly — it proposes a plan with the steps, risk, and cost, and waits for you to approve before anything runs. See Plans & approvals.

​
Next steps

Core concepts

Teams, scopes, plans, memory, and the credential model.

Invite your team

Add members and set roles.

Automate with triggers

Run the agent on a schedule or via webhook.

Chat from Slack or iMessage

Talk to the agent where your team already is.