HostedAgent Compute Runtimes

HostedAgent hosts the whole agent loop in any registered compute runtime — pick one with a single string.

Quick Start

Anthropic-hosted loop

from praisonaiagents import Agent
from praisonai import HostedAgent

agent = Agent(backend=HostedAgent(provider="anthropic"))
agent.start("Summarise today's meeting notes.")

Daytona-hosted loop

from praisonaiagents import Agent
from praisonai import HostedAgent, HostedAgentConfig

agent = Agent(backend=HostedAgent(
    provider="daytona",
    config=HostedAgentConfig(model="gpt-4o-mini", name="RemoteDev"),
))
agent.start("Set up a Python project and run pytest.")

Which provider should I pick?

The scenario picks the string.

How it resolves — the backend registry

HostedAgent(provider=...) is a factory: it looks the provider up in ManagedBackendRegistry and returns the resolved backend. anthropic is a builtin; every registered compute runtime — docker included as of PR #4077 — resolves through the same registry and runs on one generic backend.

Provider matrix

Provider	Extra install	Env var	Persistent	Best for
`anthropic`	(builtin)	`ANTHROPIC_API_KEY`	❌	Anthropic-hosted loops
`docker`	`pip install "praisonai[docker]"`	(local daemon)	❌	Local isolation
`e2b`	`pip install "praisonai[e2b]"`	`E2B_API_KEY`	❌	Instant cloud VM
`modal`	`pip install "praisonai[modal]"`	Modal auth	❌	Serverless burst
`daytona`	`pip install "praisonai[daytona]"`	`DAYTONA_API_KEY`	✅	Persistent dev workspaces
`flyio`	Fly.io token	`FLY_API_TOKEN`	❌	Fly Machines
`tenki`	`pip install "praisonai[tenki]"`	Tenki auth	❌	Tenki cloud

Custom image / template

Since PR #4077 the generic backend honours image= — one string maps to each provider’s native concept.

Provider	`image=` honoured as
`docker`	Docker image ref
`e2b`	E2B template name (unless `metadata["e2b_template"]` is set)
`modal`	Registry image ref via `Image.from_registry(...)`
`daytona`, `flyio`, `tenki`	Not applicable (uses provider-native workspace/image handling)

from praisonaiagents import Agent
from praisonai import HostedAgent, HostedAgentConfig

# Same string across providers — each maps it to the right native concept.
agent = Agent(backend=HostedAgent(
    provider="modal",
    config=HostedAgentConfig(model="gpt-4o-mini"),
    image="ghcr.io/my-org/my-runtime:latest",
))
agent.start("Do something in my custom image.")

The default image is python:3.12-slim; image= is honoured only when set to something other than that default.

Daytona notes

Two Daytona defects were fixed in PR #4074.

Memory unit. ComputeConfig takes memory_mb (megabytes). Daytona’s native unit is GiB, so the provider converts automatically — memory_gib = max(1, round((memory_mb or 1024) / 1024)). The default ComputeConfig() now provisions 1 GiB instead of asking for 1024 GiB. Sub-1024 MB requests floor to 1 GiB (never 0).

File uploads. Uploading a local file copies the file’s contents to the remote destination (upload_file(content, remote_path)). Earlier versions swapped the arguments and wrote the path string into a file named after the content.

What HostedAgent will NOT accept

openai, gemini, ollama, and local are LLM routing names, not runtimes. HostedAgent raises ValueError("... not yet available. Use LocalAgent ...").

from praisonai import LocalAgent, LocalAgentConfig

agent = LocalAgent(config=LocalAgentConfig(model="openai/gpt-4o"))
agent.start("Draft a release note.")

Common Patterns

Swap the provider without touching agent code

The provider is one string; the agent stays the same.

from praisonaiagents import Agent
from praisonai import HostedAgent, HostedAgentConfig

def build(provider: str) -> Agent:
    return Agent(backend=HostedAgent(
        provider=provider,
        config=HostedAgentConfig(model="gpt-4o-mini"),
    ))

agent = build("daytona")
agent.start("Run the test suite.")

Pick the provider per environment

Read the provider from an env var to switch cloud vs local.

import os
from praisonaiagents import Agent
from praisonai import HostedAgent

provider = os.environ.get("HOSTED_PROVIDER", "anthropic")
agent = Agent(backend=HostedAgent(provider=provider))
agent.start("Summarise the changelog.")

Best Practices

Prefer anthropic for zero-setup hosted loops

provider="anthropic" needs only ANTHROPIC_API_KEY — no extra install, no daemon. Reach for a compute runtime when you need your own isolation, persistence, or a specific cloud.

Keep the provider swappable

Pass the provider as a plain string from config or an env var. Every registered runtime shares the same HostedAgent(provider=..., config=...) shape, so switching clouds never touches agent code.

Use LocalAgent for LLM-only routing

openai, gemini, ollama, and local are not runtimes. Use LocalAgent(config=LocalAgentConfig(model="...")) for those, and add compute="..." when you want cloud-sandboxed tools with a local loop.

Daytona for persistent workspaces

daytona is the only runtime in the matrix that persists between runs — pick it when you want a dev workspace to survive across sessions. Remember memory_mb is megabytes; the provider converts to GiB.

Hosted Agent

The base class and its Anthropic path.

Placement — where does my agent run?

Short form: Agent(run_on="daytona").

Managed Backend Plugins

Self-Hosted Agent (Docker)

provider="docker" runs the whole loop in a container you own.

Getting Started

Install

Core Concepts

Guides

Features

Models

Databases

Observability

Memory

Telemetry & Analytics

Knowledge

RAG

Persistence

Tools

Other Features

Developers

Configuration

Best Practices

Getting Started (No Code)

HostedAgent Compute Runtimes

Quick Start

Which provider should I pick?

How it resolves — the backend registry

Provider matrix

Custom image / template

Daytona notes

What HostedAgent will NOT accept

Common Patterns

Swap the provider without touching agent code

Pick the provider per environment

Best Practices

Hosted Agent

Placement — where does my agent run?

Managed Backend Plugins

Self-Hosted Agent (Docker)

​Quick Start

​Which provider should I pick?

​How it resolves — the backend registry

​Provider matrix

​Custom image / template

​Daytona notes

​What HostedAgent will NOT accept

​Common Patterns

​Swap the provider without touching agent code

​Pick the provider per environment

​Best Practices

​Related

Hosted Agent

Placement — where does my agent run?

Managed Backend Plugins

Self-Hosted Agent (Docker)

Quick Start

Which provider should I pick?

How it resolves — the backend registry

Provider matrix

Custom image / template

Daytona notes

What HostedAgent will NOT accept

Common Patterns

Swap the provider without touching agent code

Pick the provider per environment

Best Practices

Related