Getting started

Install Agent Cloud locally, configure one cloud provider, and run your first deployment.

Prerequisites

You only need the tools for the cloud provider you plan to deploy to.

Required

Node.js 20+ and pnpm.

Cloud CLIs

AWS CLI, gcloud, or Azure CLI.

API key

OpenAI or Gemini key for the AI agents.

Install and build

Clone the repo, install dependencies, then build.

git clone https://github.com/intojhanurag/agent-cloud.git
cd agent-cloud

pnpm install
pnpm build

Link the CLI

Make cloud-agent available globally from your local checkout.

pnpm link --global

Set environment variables

Create a .env file in the repo root.

# Choose one
OPENAI_API_KEY=your_key
# Or
GOOGLE_GENERATIVE_AI_API_KEY=your_key

# Optional examples
AWS_REGION=us-east-1
GCLOUD_PROJECT=your-project
AZURE_LOCATION=eastus

Authenticate your cloud provider

Pick one of the following.

AWS

aws configure

GCP

gcloud auth login
gcloud config set project YOUR_PROJECT_ID

Azure

az login

Your first deployment

Run a deployment from inside your application project directory.

cd /path/to/your/project

cloud-agent deploy --cloud aws

# Or auto-approve
cloud-agent deploy --cloud aws --yes