agenta 0.36.3__py3-none-any.whl → 0.36.4__py3-none-any.whl

agenta/cli/variant_commands.py

@@ -1,526 +0,0 @@
-import os
-import re
-import sys
-from typing import List
-from pathlib import Path
-
-from requests.exceptions import ConnectionError
-
-import click
-import questionary
-import toml
-
-from agenta.cli import helper
-from agenta.cli.telemetry import event_track
-from agenta.client.backend.client import AgentaApi
-from agenta.client.api import add_variant_to_server
-from agenta.client.api_models import AppVariant, Image
-from agenta.docker.docker_utils import build_tar_docker_container
-from agenta.client.backend.types.variant_action import VariantAction
-
-
-BACKEND_URL_SUFFIX = os.environ.get("BACKEND_URL_SUFFIX", "api")
-
-
-@click.group()
-def variant():
-    """Commands for variants"""
-    pass
-
-
-def add_variant(
-    app_folder: str, file_name: str, host: str, overwrite: bool, config_name="default"
-) -> str:
-    """
-    Adds a variant to the backend. Sends the code as a tar to the backend, which then containerizes it and adds it to the backend store.
-    The app variant name to be added is
-    {file_name.removesuffix(".py")}.{config_name}
-    Args:
-        variant_name: the name of the variant
-        app_folder: the folder of the app
-        file_name: the name of the file to run.
-        config_name: the name of the config to use for now it is always default
-    Returns:
-        the name of the code base and variant(useful for serve)
-    """
-
-    app_path = Path(app_folder)
-    config_file = app_path / "config.toml"
-    config = toml.load(config_file)
-
-    app_name = config["app_name"]
-    app_id = config["app_id"]
-    api_key = config.get("api_key", "")
-
-    config_name = "default"
-    base_name = file_name.removesuffix(".py")
-    variant_name = f"{base_name}.{config_name}"
-
-    # check files in folder
-    app_file = app_path / file_name
-    if not app_file.exists():
-        click.echo(
-            click.style(
-                f"No {file_name} exists! Please make sure you are in the right directory",
-                fg="red",
-            )
-        )
-        return None
-
-    env_file = app_path / ".env"
-    if not env_file.exists():
-        continue_without_env = questionary.confirm(
-            "No .env file found! Are you sure you handled the API keys needed in your application?\n Do you want to continue without it?"
-        ).ask()
-        if not continue_without_env:
-            click.echo("Operation cancelled.")
-            sys.exit(0)
-
-    requirements_file = app_path / "requirements.txt"
-    if not requirements_file.exists():
-        continue_without_requirements = questionary.confirm(
-            "No requirements.txt file found! Are you sure you do not need it in your application?\n Do you want to continue without it?"
-        ).ask()
-        if not continue_without_requirements:
-            click.echo("Operation cancelled.")
-            sys.exit(0)
-
-    # Validate variant name
-    if not re.match("^[a-zA-Z0-9_]+$", base_name):
-        click.echo(
-            click.style(
-                "Invalid input. Please use only alphanumeric characters without spaces in the filename.",
-                fg="red",
-            )
-        )
-        sys.exit(0)
-
-    # update the config file with the variant names from the backend
-    variant_name = f"{base_name}.{config_name}"
-
-    client = AgentaApi(
-        base_url=f"{host}/{BACKEND_URL_SUFFIX}",
-        api_key=api_key,
-    )
-
-    if variant_name in config["variants"] and not overwrite:
-        if not overwrite:
-            overwrite = questionary.confirm(
-                "This variant already exists. Do you want to overwrite it?"
-            ).ask()
-            if not overwrite:
-                click.echo("Operation cancelled.")
-                return
-
-    try:
-        click.echo(
-            click.style(
-                f"Preparing code base {base_name} into a tar file...",
-                fg="bright_black",
-            )
-        )
-        tar_path = build_tar_docker_container(folder=app_path, file_name=file_name)
-
-        click.echo(
-            click.style(
-                f"Building code base {base_name} for {variant_name} into a docker image...",
-                fg="bright_black",
-            )
-        )
-        with tar_path.open("rb") as tar_file:
-            built_image: Image = client.containers.build_image(
-                app_id=app_id,
-                base_name=base_name,
-                tar_file=tar_file,
-            )
-            image = Image(**built_image.dict())
-        if tar_path.exists():
-            tar_path.unlink()
-
-    except Exception as ex:
-        click.echo(click.style(f"Error while building image: {ex}", fg="red"))
-        raise
-    try:
-        if overwrite:
-            click.echo(
-                click.style(
-                    f"Updating {base_name} to server...",
-                    fg="bright_black",
-                )
-            )
-            variant_id = config["variant_ids"][config["variants"].index(variant_name)]
-            client.variants.update_variant_image(
-                variant_id=variant_id,
-                docker_id=image.docker_id,
-                tags=image.tags,
-                type=image.type,
-            )  # this automatically restarts
-        else:
-            click.echo(click.style(f"Adding {variant_name} to server...", fg="yellow"))
-            response = add_variant_to_server(
-                app_id,
-                base_name,
-                image,
-                f"{host}/{BACKEND_URL_SUFFIX}",
-                api_key,
-            )
-            variant_id = response["variant_id"]
-            config["variants"].append(variant_name)
-            config["variant_ids"].append(variant_id)
-    except Exception as ex:
-        if overwrite:
-            click.echo(click.style(f"Error while updating variant: {ex}", fg="red"))
-        else:
-            click.echo(click.style(f"Error while adding variant: {ex}", fg="red"))
-        raise
-
-    agenta_dir = Path.home() / ".agenta"
-    global_toml_file = toml.load(agenta_dir / "config.toml")
-    tracking_enabled: bool = global_toml_file["telemetry_tracking_enabled"]
-    if overwrite:
-        # Track a deployment event
-        if tracking_enabled:
-            get_user_id = client.fetch_user_profile()
-            user_id = get_user_id["id"]
-            event_track.capture_event(
-                "app_deployment",
-                body={
-                    "app_id": app_id,
-                    "deployed_by": user_id,
-                    "environment": "CLI",
-                    "version": "cloud" if api_key else "oss",
-                },
-            )
-
-        click.echo(
-            click.style(
-                f"Variant {variant_name} for App {app_name} updated successfully 🎉",
-                bold=True,
-                fg="green",
-            )
-        )
-    else:
-        # Track a deployment event
-        if tracking_enabled:
-            get_user_id = client.fetch_user_profile()
-            user_id = get_user_id["id"]
-            event_track.capture_event(
-                "app_deployment",
-                body={
-                    "app_id": app_id,
-                    "deployed_by": user_id,
-                    "environment": "CLI",
-                    "version": "cloud" if api_key else "oss",
-                },
-            )
-
-        click.echo(
-            click.style(
-                f"Variant {variant_name} for App {app_name} added successfully to Agenta!",
-                fg="green",
-            )
-        )
-    # Last step us to save the config file
-    toml.dump(config, config_file.open("w"))
-    if overwrite:
-        # In the case we are overwriting, don't return anything. Otherwise the command server would attempt to start the container which would result in an error!!!
-        # TODO: Improve this stupid design
-        return None
-    else:
-        return variant_id
-
-
-def start_variant(variant_id: str, app_folder: str, host: str):
-    """
-    Starts a container for an existing variant
-    Args:
-        variant_name: the name of the variant
-        app_folder: the folder of the app
-    """
-    app_folder = Path(app_folder)
-    config_file = app_folder / "config.toml"
-    config = toml.load(config_file)
-    app_id = config["app_id"]
-    api_key = config.get("api_key", "")
-
-    if len(config["variants"]) == 0:
-        click.echo("No variants found. Please add a variant first.")
-        return
-
-    if variant_id:
-        if variant_id not in config["variant_ids"]:
-            click.echo(
-                click.style(
-                    f"Variant {variant_id} not found in backend. Maybe you removed it in the webUI?",
-                    fg="red",
-                )
-            )
-            return
-    else:
-        variant_name = questionary.select(
-            "Please choose a variant", choices=config["variants"]
-        ).ask()
-        variant_id = config["variant_ids"][config["variants"].index(variant_name)]
-
-    client = AgentaApi(
-        base_url=f"{host}/{BACKEND_URL_SUFFIX}",
-        api_key=api_key,
-    )
-
-    variant = client.variants.start_variant(
-        variant_id=variant_id,
-        action=VariantAction(action="START"),
-    )
-    endpoint = variant.uri
-    click.echo("\n" + click.style("Congratulations! 🎉", bold=True, fg="green"))
-    click.echo(
-        click.style("Your app has been deployed locally as an API. 🚀", fg="cyan")
-        + click.style(" You can access it here: ", fg="white")
-        + click.style(f"{endpoint}/", bold=True, fg="yellow")
-    )
-
-    click.echo(
-        click.style("\nRead the API documentation. 📚", fg="cyan")
-        + click.style(" It's available at: ", fg="white")
-        + click.style(f"{endpoint}/docs", bold=True, fg="yellow")
-    )
-
-    webui_host = "http://localhost" if host == "localhost" else host
-    click.echo(
-        click.style(
-            "\nStart experimenting with your app in the playground. 🎮",
-            fg="cyan",
-        )
-        + click.style(" Go to: ", fg="white")
-        + click.style(f"{webui_host}/apps/{app_id}/playground", bold=True, fg="yellow")
-        + "\n"
-    )
-
-
-def remove_variant(variant_name: str, app_folder: str, host: str):
-    """
-    Removes a variant from the server
-    Args:
-        variant_name: the name of the variant
-        app_folder: the folder of the app
-    """
-    config_file = Path(app_folder) / "config.toml"
-    config = toml.load(config_file)
-    app_name = config["app_name"]
-    api_key = config.get("api_key", "")
-
-    if not config["variants"]:
-        click.echo(
-            click.style(
-                f"No variants found for app {app_name}. Make sure you have deployed at least one variant.",
-                fg="red",
-            )
-        )
-        return
-
-    if variant_name:
-        if variant_name not in config["variants"]:
-            click.echo(
-                click.style(
-                    f"Variant {variant_name} not found in backend. Maybe you already removed it in the webUI?",
-                    fg="red",
-                )
-            )
-            return
-    else:
-        variant_name = questionary.select(
-            "Please choose a variant", choices=config["variants"]
-        ).ask()
-    variant_id = config["variant_ids"][config["variants"].index(variant_name)]
-
-    client = AgentaApi(
-        base_url=f"{host}/{BACKEND_URL_SUFFIX}",
-        api_key=api_key,
-    )
-
-    try:
-        client.variants.remove_variant(variant_id=variant_id)
-    except Exception as ex:
-        click.echo(
-            click.style(
-                f"Error while removing variant {variant_name} for App {app_name} from the backend",
-                fg="red",
-            )
-        )
-        click.echo(click.style(f"Error message: {ex}", fg="red"))
-        return
-
-    click.echo(
-        click.style(
-            f"Variant {variant_name} for App {app_name} removed successfully from Agenta!",
-            fg="green",
-        )
-    )
-
-
-def list_variants(app_folder: str, host: str):
-    """List available variants for an app and print them to the console
-
-    Arguments:
-        app_folder -- _description_
-    """
-    config_file = Path(app_folder) / "config.toml"
-    config = toml.load(config_file)
-    app_name = config["app_name"]
-    app_id = config["app_id"]
-    api_key = config.get("api_key", "")
-    variants = []
-
-    client = AgentaApi(
-        base_url=f"{host}/{BACKEND_URL_SUFFIX}",
-        api_key=api_key,
-    )
-
-    try:
-        variants: List[AppVariant] = client.apps.list_app_variants(app_id=app_id)
-    except Exception as ex:
-        raise ex
-
-    if variants:
-        for variant in variants:
-            helper.display_app_variant(variant)
-    else:
-        click.echo(click.style(f"No variants found for app {app_name}", fg="red"))
-
-
-def config_check(app_folder: str):
-    """Check the config file and update it from the backend
-
-    Arguments:
-        app_folder -- the app folder
-    """
-
-    click.echo(click.style("\nChecking and updating config file...", fg="bright_black"))
-    app_folder = Path(app_folder)
-    config_file = app_folder / "config.toml"
-    if not config_file.exists():
-        click.echo(
-            click.style(
-                f"Config file not found in {app_folder}. Make sure you are in the right folder and that you have run agenta init first.",
-                fg="red",
-            )
-        )
-        return
-    host = get_host(app_folder)  # TODO: Refactor the whole config thing
-    helper.update_config_from_backend(config_file, host=host)
-
-
-def get_host(app_folder: str) -> str:
-    """Fetches the host from the config"""
-    app_folder = Path(app_folder)
-    config_file = app_folder / "config.toml"
-    config = toml.load(config_file)
-    if "backend_host" not in config:
-        host = "http://localhost"
-    else:
-        host = config["backend_host"]
-    return host
-
-
-@variant.command(name="remove")
-@click.option("--app_folder", default=".")
-@click.option("--variant_name", default="")
-def remove_variant_cli(variant_name: str, app_folder: str):
-    """Remove an existing variant."""
-
-    try:
-        config_check(app_folder)
-        remove_variant(
-            variant_name=variant_name,
-            app_folder=app_folder,
-            host=get_host(app_folder),
-        )
-    except Exception as ex:
-        click.echo(click.style(f"Error while removing variant: {ex}", fg="red"))
-
-
-@variant.command(
-    name="serve",
-    context_settings=dict(
-        ignore_unknown_options=True,
-        allow_extra_args=True,
-    ),
-)
-@click.option("--app_folder", default=".")
-@click.option("--file_name", default=None, help="The name of the file to run")
-@click.option(
-    "--overwrite",
-    is_flag=True,
-    help="Overwrite the existing variant if it exists",
-)
-@click.pass_context
-def serve_cli(ctx, app_folder: str, file_name: str, overwrite: bool):
-    """Adds a variant to the web UI and serves the API locally."""
-
-    if not file_name:
-        if ctx.args:
-            file_name = ctx.args[0]
-        else:
-            error_msg = "To serve variant, kindly provide the filename and run:\n"
-            error_msg += ">>> agenta variant serve --file_name <filename>.py\n"
-            error_msg += "or\n"
-            error_msg += ">>> agenta variant serve <filename>.py"
-            click.echo(click.style(f"{error_msg}", fg="red"))
-            sys.exit(1)
-
-    try:
-        config_check(app_folder)
-    except Exception as e:
-        click.echo(click.style("Failed during configuration check.", fg="red"))
-        click.echo(click.style(f"Error message: {str(e)}", fg="red"))
-        sys.exit(1)
-
-    try:
-        host = get_host(app_folder)
-    except Exception as e:
-        click.echo(click.style("Failed to retrieve the host.", fg="red"))
-        click.echo(click.style(f"Error message: {str(e)}", fg="red"))
-        sys.exit(1)
-
-    try:
-        api_key = helper.get_global_config("api_key")
-    except Exception as e:
-        click.echo(click.style("Failed to retrieve the api key.", fg="red"))
-        click.echo(click.style(f"Error message: {str(e)}", fg="red"))
-        sys.exit(1)
-
-    try:
-        variant_id = add_variant(
-            app_folder=app_folder, file_name=file_name, host=host, overwrite=overwrite
-        )
-    except Exception as e:
-        click.echo(click.style("Failed to add variant.", fg="red"))
-        click.echo(click.style(f"Error message: {str(e)}", fg="red"))
-        sys.exit(1)
-
-    if variant_id:
-        try:
-            start_variant(variant_id=variant_id, app_folder=app_folder, host=host)
-        except ConnectionError:
-            error_msg = "Failed to connect to Agenta backend. Here's how you can solve the issue:\n"
-            error_msg += "- First, please ensure that the backend service is running and accessible.\n"
-            error_msg += (
-                "- Second, try restarting the containers (if using Docker Compose)."
-            )
-            click.echo(click.style(f"{error_msg}", fg="red"))
-            sys.exit(1)
-        except Exception as e:
-            click.echo(click.style("Failed to start container with LLM app.", fg="red"))
-            click.echo(click.style(f"Error message: {str(e)}", fg="red"))
-            sys.exit(1)
-
-
-@variant.command(name="list")
-@click.option("--app_folder", default=".")
-def list_variants_cli(app_folder: str):
-    """List the variants in the backend"""
-    try:
-        config_check(app_folder)
-        list_variants(app_folder=app_folder, host=get_host(app_folder))
-    except Exception as ex:
-        click.echo(click.style(f"Error while listing variants: {ex}", fg="red"))

agenta/cli/variant_configs.py

@@ -1,49 +0,0 @@
-import click
-from agenta.cli import helper
-
-
-@click.group()
-def config():
-    """Commands for variants configurations"""
-    pass
-
-
-def update_backend_host(backend_host: str):
-    """Check the config file and update the backend URL
-
-    Arguments:
-        app_folder -- the app folder
-        backend_host -- the backend host
-    """
-
-    click.echo(
-        click.style("\nChecking and updating global backend host...", fg="bright_black")
-    )
-    helper.set_global_config("host", backend_host)
-
-
-@config.command(
-    name="set-host",
-    context_settings=dict(
-        ignore_unknown_options=True,
-        allow_extra_args=True,
-    ),
-)
-@click.option(
-    "--backend_host", default=None, help="The URL of the backend host to use."
-)
-@click.pass_context
-def set_config_url(ctx, backend_host: str):
-    """Set the backend URL in the app configuration"""
-
-    try:
-        if not backend_host:
-            if ctx.args:
-                backend_host = ctx.args[0]
-            else:
-                click.echo(click.style("Backend host URL not specified", fg="red"))
-
-        update_backend_host(backend_host)
-        click.echo(click.style("Backend host updated successfully! 🎉\n"))
-    except Exception as ex:
-        click.echo(click.style(f"Error updating backend host: {ex}", fg="red"))

agenta/client/api.py

@@ -1,74 +0,0 @@
-import os
-import toml
-import time
-import click
-from typing import Dict
-from pathlib import Path
-from agenta.client.backend import client
-from agenta.client.api_models import Image
-from requests.exceptions import RequestException
-from agenta.client.backend.client import AgentaApi
-from agenta.client.exceptions import APIRequestError
-
-
-def add_variant_to_server(
-    app_id: str,
-    base_name: str,
-    image: Image,
-    backend_url: str,
-    api_key: str,
-    retries=10,
-    backoff_factor=1,
-) -> Dict:
-    """
-    Adds a variant to the server with a retry mechanism and a single-line loading state.
-
-    Args:
-        app_id (str): The ID of the app to add the variant to.
-        base_name (str): The base name for the variant.
-        image (Image): The image to use for the variant.
-        retries (int): Number of times to retry the request.
-        backoff_factor (float): Factor to determine the delay between retries (exponential backoff).
-
-    Returns:
-        dict: The JSON response from the server.
-
-    Raises:
-        APIRequestError: If the request to the server fails after retrying.
-    """
-
-    click.echo(
-        click.style("Waiting for the variant to be ready", fg="yellow"), nl=False
-    )
-
-    client = AgentaApi(
-        base_url=backend_url,
-        api_key=api_key,
-    )
-    for attempt in range(retries):
-        try:
-            response = client.apps.add_variant_from_image(
-                app_id=app_id,
-                variant_name=f"{base_name.lower()}.default",
-                base_name=base_name,
-                config_name="default",
-                docker_id=image.docker_id,
-                tags=image.tags,
-            )
-            click.echo(click.style("\nVariant added successfully!", fg="green"))
-            return response
-        except RequestException as e:
-            if attempt < retries - 1:
-                click.echo(click.style(".", fg="yellow"), nl=False)
-                time.sleep(backoff_factor * (2**attempt))
-            else:
-                raise APIRequestError(
-                    click.style(
-                        f"\nRequest to app_variant endpoint failed with status code {response.status_code} and error message: {e}.",
-                        fg="red",
-                    )
-                )
-        except Exception as e:
-            raise APIRequestError(
-                click.style(f"\nAn unexpected error occurred: {e}", fg="red")
-            )

agenta/client/api_models.py

@@ -1,34 +0,0 @@
-from pydantic import BaseModel
-from typing import List, Optional, Dict, Any
-
-
-class AppVariant(BaseModel):
-    app_id: str
-    app_name: str
-    variant_name: str
-    variant_id: str
-    parameters: Optional[Dict[str, Any]]
-    previous_variant_name: Optional[str]
-    base_name: Optional[str]
-    config_name: Optional[str]
-
-
-class Variant(BaseModel):
-    variant_id: str
-
-
-class Image(BaseModel):
-    type: Optional[str]
-    docker_id: str
-    tags: str
-
-
-class URI(BaseModel):
-    uri: str
-
-
-class VariantConfigPayload(BaseModel):
-    base_id: str
-    config_name: str
-    parameters: Dict[str, Any]
-    overwrite: bool