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

# RunAgent Cloud Overview

> Serverless infrastructure for deploying and running AI agents at scale

> RunAgent Cloud provides a fully managed, serverless infrastructure for deploying and running your AI agents. No infrastructure management, automatic scaling, and global availability.

## What is RunAgent Cloud?

RunAgent Cloud is a serverless platform designed specifically for AI agents. It handles all the infrastructure complexity so you can focus on building great agents.

### Key Benefits

<CardGroup cols={2}>
  <Card title="Serverless Architecture" icon="cloud">
    Fully managed infrastructure with zero configuration. Deploy and scale automatically.
  </Card>

  <Card title="Automatic Scaling" icon="chart-line">
    Scale from zero to thousands of requests without manual intervention.
  </Card>

  <Card title="Global Availability" icon="globe">
    Deploy once, access from anywhere with low-latency global distribution.
  </Card>

  <Card title="Multiple VM Images" icon="server">
    Automatic image selection based on your agent's requirements and dependencies.
  </Card>
</CardGroup>

## Serverless Infrastructure

RunAgent Cloud operates on a serverless model where:

* **No servers to manage** - Infrastructure is fully managed by RunAgent
* **Pay per use** - Only pay for actual agent execution time
* **Automatic scaling** - Handles traffic spikes without configuration
* **Zero maintenance** - Updates, patches, and security handled automatically
* **High availability** - Built-in redundancy and failover

### How It Works

1. **Deploy your agent** - Upload your agent code with a single command
2. **Automatic provisioning** - RunAgent Cloud selects the optimal VM image
3. **On-demand execution** - Agents start when needed, scale automatically
4. **Global distribution** - Requests routed to nearest available instance

## VM Image Management

RunAgent Cloud supports multiple VM images optimized for different use cases and dependencies.

### Automatic Image Selection

The platform automatically selects the appropriate VM image based on:

* **Framework requirements** - LangGraph, CrewAI, custom frameworks
* **Dependencies** - Python packages, system libraries
* **Resource needs** - CPU, memory, GPU requirements
* **Optimization** - Best performance for your specific agent

You don't need to specify which image to use - RunAgent Cloud handles this automatically.

### Deployment Time

Initial deployment time varies based on the selected VM image:

* **Standard images**: Typically ready in 30-60 seconds
* **Specialized images**: May take up to 2 minutes for first deployment
* **Subsequent requests**: Cached images start in seconds

The platform optimizes for your agent's specific needs, which may require pulling specialized images on first deployment.

### Image Availability

RunAgent Cloud currently supports multiple VM images optimized for:

* Python-based agents with various framework requirements
* Different dependency sets and system library needs
* Performance-optimized configurations

**More VM images coming soon** - We're continuously expanding image support to cover additional frameworks, languages, and use cases.

## Getting Started

### Quick Start

```bash theme={null}
# 1. Authenticate with RunAgent Cloud
runagent setup --api-key <your-api-key>

# 2. Deploy your agent
runagent deploy --folder ./my-agent

# 3. Your agent is live and accessible globally
```

### Next Steps

<CardGroup cols={2}>
  <Card title="Cloud Deployment Guide" href="/runagent-cloud/cloud-deployment" arrow>
    Complete guide to deploying agents to RunAgent Cloud
  </Card>

  <Card title="Local Development" href="/deployment/local-development" arrow>
    Test agents locally before deploying to cloud
  </Card>

  <Card title="Authentication" href="/runagent-cloud/cloud-deployment#authentication-setup" arrow>
    Set up API keys and authentication
  </Card>

  <Card title="Monitoring" href="/explanation/production-considerations" arrow>
    Monitor and manage your deployed agents
  </Card>
</CardGroup>

## Architecture

RunAgent Cloud provides:

* **Isolated execution environments** - Each agent runs in its own secure container
* **Load balancing** - Automatic request distribution across instances
* **Health monitoring** - Continuous health checks and automatic recovery
* **Logging and metrics** - Comprehensive observability for all agents
* **API gateway** - Unified interface for all agent interactions

## Pricing Model

RunAgent Cloud uses a usage-based pricing model:

* **No upfront costs** - Pay only for what you use
* **Per-execution pricing** - Based on actual agent runtime
* **Transparent billing** - Clear visibility into usage and costs
* **Free tier available** - Get started with free credits

## Security

RunAgent Cloud includes enterprise-grade security:

* **Isolated execution** - Complete isolation between agents
* **Encrypted connections** - All traffic encrypted in transit
* **API key authentication** - Secure access control
* **Audit logging** - Complete activity tracking
* **Compliance ready** - Built with security best practices

## Comparison: Local vs Cloud

| Feature          | Local Development          | RunAgent Cloud     |
| ---------------- | -------------------------- | ------------------ |
| **Setup**        | Manual configuration       | Zero configuration |
| **Scaling**      | Manual                     | Automatic          |
| **Availability** | When your machine is on    | 24/7 global        |
| **Maintenance**  | You manage                 | Fully managed      |
| **Cost**         | Free (your infrastructure) | Pay per use        |
| **Best for**     | Development, testing       | Production         |

## Support and Resources

* **Documentation** - Comprehensive guides and references
* **Dashboard** - Web interface for managing agents
* **Community** - Discord community for support
* **Status page** - Real-time platform status

## Next Steps

Ready to deploy to RunAgent Cloud? Start with the [Cloud Deployment Guide](/runagent-cloud/cloud-deployment) to learn how to deploy your first agent.

<Card title="Still have a question?" icon="circle-question" href="/components/columns">
  * Join our [Discord Community](https://discord.gg/Q9P9AdHVHz)
  * Email us: [hi@run-agent.ai](mailto:hi@run-agent.ai)
  * Follow us on [X](https://x.com/run_agent)
  * New here? [Sign up](https://run-agent.ai/dashboard)
</Card>