AgentOS serve: reload is unsupported

Why AgentOS.serve(reload=True) cannot hot-reload and how to get reload instead

A programmatically built AgentOS cannot hot-reload — serve(reload=True) warns and serves without reload.

Quick Start

1. What happens today

   serve(reload=True) on a programmatic AgentOS emits a UserWarning and runs without reload:

   from praisonai import AgentOS
   from praisonaiagents import Agent
   
   assistant = Agent(name="assistant", instructions="Be helpful.")
   
   AgentOS(agents=[assistant]).serve(reload=True)
   # UserWarning: reload is unsupported for a programmatically built AgentOS;
   # serving without reload.

   The CLI praisonai app --reload prints the same guidance in yellow.

2. Get reload with a module factory

   Expose your AgentOS as a module-level factory and run uvicorn against the import string:

   # mymodule.py
   from praisonai import AgentOS
   from praisonaiagents import Agent
   
   def create_app():
       return AgentOS(agents=[Agent(name="assistant", instructions="Be helpful.")]).get_app()

   uvicorn "mymodule:create_app" --factory --reload

Why reload is unsupported

Uvicorn’s reload worker runs in a separate process and re-imports the target module.

A programmatically built AgentOS(agents=[...]) has no importable module-level app. The reload worker would start empty and fail, so serve(reload=True) warns and serves without reload rather than crash.

Common Patterns

Development with reload

Point uvicorn at your factory so edits to mymodule.py reload automatically:

uvicorn "mymodule:create_app" --factory --reload --port 8000

Production without reload

For production, call serve() directly — reload is a development-only convenience:

from praisonai import AgentOS
from praisonaiagents import Agent

AgentOS(agents=[Agent(name="assistant", instructions="Be helpful.")]).serve(port=8000)

Best Practices

Related