HostedAgent Compute Runtimes

Run the whole agent loop in Docker, E2B, Modal, Daytona, Fly.io, or Tenki — one class, one string

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

Quick Start

1. Anthropic-hosted loop

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

2. 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

Custom image / template

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

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.

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

Related