Skip to content

Agent Zero AI framework

2.9 KB
Raw Blame
import initialize
from helpers import dotenv, extension, runtime
from helpers.api import csrf_protect, requires_auth
from helpers.print_style import PrintStyle
from helpers.server_startup import run_uvicorn_with_retries
from helpers.ui_server import UiServerRuntime, configure_process_environment


def run():
    configure_process_environment()
    PrintStyle().print("Initializing Python framework...")
    PrintStyle().print("Checking for data migration...")
    run_migration_checks()

    PrintStyle().print("Preparing web server runtime...")
    server_runtime, host, port = prepare_web_runtime()

    PrintStyle().print("Initializing Agent Zero components...")
    finish_init = init_a0()
    if callable(finish_init):
        finish_init()

    PrintStyle().print("Starting UI/API server...")
    start_web_server(server_runtime, host, port)


def run_migration_checks() -> None:
    initialize.initialize_migration()


def prepare_web_runtime() -> tuple[UiServerRuntime, str, int]:
    host = (
        runtime.get_arg("host") or dotenv.get_dotenv_value("WEB_UI_HOST") or "localhost"
    )
    port = runtime.get_web_ui_port()
    server_runtime = UiServerRuntime.create()
    server_runtime.register_http_routes()
    server_runtime.register_transport_handlers()

    return server_runtime, host, port


def start_web_server(server_runtime: UiServerRuntime, host: str, port: int) -> None:
    run_uvicorn_with_retries(
        host=host,
        port=port,
        build_asgi_app=server_runtime.build_asgi_app,
        flush_callback=create_flush_callback(),
        access_log=server_runtime.access_log_enabled(),
        ws="wsproto",
    )


def create_flush_callback():
    def flush_and_shutdown_callback() -> None:
        """
        TODO(dev): add cleanup + flush-to-disk logic here.
        """
        return

    flush_ran = False

    def _run_flush(reason: str) -> None:
        nonlocal flush_ran
        if flush_ran:
            return
        flush_ran = True
        try:
            flush_and_shutdown_callback()
        except Exception as e:
            PrintStyle.warning(f"Shutdown flush failed ({reason}): {e}")

    return _run_flush


@extension.extensible
def init_a0():
    init_preload = initialize.initialize_preload()
    init_chats = initialize.initialize_chats()
    init_chats.result_sync()

    def finish_init():
        # Give the first chat a warm model without waiting indefinitely on downloads.
        if init_preload:
            try:
                init_preload.result_sync(timeout=10)
            except TimeoutError:
                pass
            except Exception as e:
                PrintStyle().error(f"Error waiting for preload: {e}")

        initialize.initialize_mcp()
        initialize.initialize_job_loop()

    # Let end hooks run during warmup before waiting and starting MCP/jobs.
    return finish_init


if __name__ == "__main__":
    runtime.initialize()
    dotenv.load_dotenv()
    run()