AgentOS on Render

Deploy AgentOS to Render.

This template deploys AgentOS and PostgreSQL with pgvector to Render. Automatic HTTPS and public domain included.

What’s Included

Component	Description
AgentOS	FastAPI server running your AI agents
PostgreSQL	Database with pgvector for embeddings
Automatic HTTPS	Render handles TLS certificates
Public Domain	your-app.onrender.com

Prerequisites

You’ll need:

• Docker Desktop
• uv (Python package manager)
• Render account (free tier works)
• OpenAI API key
• GitHub account (for deployment)

Install Render CLI (optional, for management):

Mac

brew install render

Deploy

Render offers two deployment methods:

Method	Plan Required	Best For
Blueprint (Dashboard)	Free or Paid	Most users, free tier
API (Script)	Paid only	Automation, CI/CD

The Render API does not support creating free-tier services. If you’re on Render’s free plan, use the Blueprint method.

Create Your Project

1. Set up Python environment

   uv venv --python 3.12
   source .venv/bin/activate
   
2. Install Agno

   uv pip install -U 'agno[infra]'
   
3. Create from template

   ag infra create --template agentos-render --name my-agentos
   cd my-agentos
   
4. Set your API key

   export OPENAI_API_KEY=sk-***
   

Included Agents

These agents are ready to use once deployed:

Pal

Personal assistant that learns from you. Stores notes, bookmarks, and research findings.

Knowledge Agent

RAG agent that answers questions from your documents. Pre-loaded with Agno docs.

MCP Agent

Connects to external tools via MCP. Extensible with any MCP-compatible service.

Deploy with Blueprint

Deploy using the Render Dashboard. Works with free and paid plans.

1. Test locally (optional)

   Create a .env file and start containers:

   echo "OPENAI_API_KEY=sk-***" > .env
   docker compose up -d --build
   

   Open http://localhost:8000/docs to verify, then stop with docker compose down.

2. Push to GitHub

   git init
   git add .
   git commit -m "Initial commit"
   git remote add origin [e-mail]:YOUR_USERNAME/my-agentos.git
   git push -u origin main
   
3. Create Blueprint on Render

   1. Go to dashboard.render.com/blueprints
   2. Click New Blueprint Instance
   3. Connect your GitHub account and select your repository
   4. Render detects render.yaml and shows resources to create

   
4. Configure environment variables

   Render prompts you to set:

   • OPENAI_API_KEY (required): Your OpenAI API key
   • EXA_API_KEY (optional): For web research features

   Database variables are configured automatically.

   
5. Deploy

   Click Apply to start deployment. Takes ~5 minutes.

6. Get your domain

   Click on agentos-api service. Your URL is at the top (e.g., https://agentos-api.onrender.com).

   Navigate to <your-domain>/docs to see your AgentOS API.

   

Connect to Control Plane

1. Connect your AgentOS

   1. Go to os.agno.com
   2. Click “Connect OS” → Select “Live”
   3. Paste your Render domain

   

Your AgentOS is live! Manage it from os.agno.com

---

Deploy with API

Deploy using a script that calls the Render API. Requires a paid plan.

The Render API does not support free-tier services. This method uses paid plans:

• Database: basic_256mb (~$7/month)
• Web Service: starter (~$7/month)

Use Blueprint deployment for free tier.

1. Push to GitHub

   git init
   git add .
   git commit -m "Initial commit"
   git remote add origin [e-mail]:YOUR_USERNAME/my-agentos.git
   git push -u origin main
   
2. Get your Render API key

   1. Go to dashboard.render.com
   2. Click profile icon → Account Settings → API Keys
   3. Click Create API Key and copy it (starts with rnd_)
3. Export API keys

   export RENDER_API_KEY=rnd_***
   export OPENAI_API_KEY=sk-***
   export EXA_API_KEY=***  # Optional
   
4. Deploy

   ./scripts/render_up.sh
   

   Creates PostgreSQL, web service, and configures environment variables.

5. Get your domain

   The script outputs your URL. Or use:

   render services
   

   Navigate to <your-domain>/docs to see your AgentOS API.

6. Connect to Control Plane

   1. Go to os.agno.com
   2. Click “Connect OS” → Select “Live”
   3. Paste your Render domain

Your AgentOS is live! Manage it from os.agno.com

Next Steps

Build Custom Agents

Create agents with your own tools and prompts.

Add Tools

Slack, GitHub, databases, and 100+ integrations.

Add Knowledge

Load documents, websites, and databases for RAG.

Add Interfaces

Deploy to Slack, Discord, WhatsApp, or expose via MCP.

Reference

Blueprint Deployment

Task	Action
View logs	Dashboard → Service → Logs tab
Redeploy	Push to GitHub (auto-deploys)
Manual redeploy	Dashboard → Manual Deploy → Deploy latest commit
Update env vars	Dashboard → Service → Environment tab
Delete resources	Dashboard → Blueprints → Settings → Delete Blueprint

API Deployment

Task	Command
View logs	render logs
SSH into service	render ssh
Connect to database	render psql
Trigger redeploy	render deploys create
List services	render services

Troubleshooting

Deployment fails

Check logs in Dashboard or via CLI: render logs. Common issues: missing environment variables, Docker build errors.

Database connection timeout

PostgreSQL takes ~30-60s to provision. Wait and retry.

Service returns 503

Container starting. Wait 2-3 minutes for health checks to pass.

API script fails with 'unknown plan'

Ensure valid plan names: basic_256mb for database, starter for web service.

Cannot create free-tier via API

Render limitation. Use Blueprint deployment instead.