llama distribution -> llama stack + containers (WIP)

llama_toolchain/cli/stack/__init__.py

@@ -0,0 +1,7 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+from .stack import StackParser  # noqa

llama_toolchain/cli/stack/configure.py

@@ -0,0 +1,106 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+import argparse
+import json
+import shlex
+
+import yaml
+from termcolor import cprint
+
+from llama_toolchain.cli.subcommand import Subcommand
+from llama_toolchain.common.config_dirs import DISTRIBS_BASE_DIR
+
+
+class StackConfigure(Subcommand):
+    """Llama cli for configuring llama toolchain configs"""
+
+    def __init__(self, subparsers: argparse._SubParsersAction):
+        super().__init__()
+        self.parser = subparsers.add_parser(
+            "configure",
+            prog="llama distribution configure",
+            description="configure a llama stack distribution",
+            formatter_class=argparse.RawTextHelpFormatter,
+        )
+        self._add_arguments()
+        self.parser.set_defaults(func=self._run_distribution_configure_cmd)
+
+    def _add_arguments(self):
+        self.parser.add_argument(
+            "--name",
+            type=str,
+            help="Name of the distribution to configure",
+            required=True,
+        )
+
+    def _run_distribution_configure_cmd(self, args: argparse.Namespace) -> None:
+        from llama_toolchain.distribution.datatypes import StackConfig
+        from llama_toolchain.distribution.registry import resolve_distribution_spec
+
+        config_file = DISTRIBS_BASE_DIR / args.name / "config.yaml"
+        if not config_file.exists():
+            self.parser.error(
+                f"Could not find {config_file}. Please run `llama distribution install` first"
+            )
+            return
+
+        # we need to find the spec from the name
+        with open(config_file, "r") as f:
+            config = StackConfig(**yaml.safe_load(f))
+
+        dist = resolve_distribution_spec(config.spec)
+        if dist is None:
+            raise ValueError(f"Could not find any registered spec `{config.spec}`")
+
+        configure_llama_distribution(dist, config)
+
+
+def configure_llama_distribution(dist: "Stack", config: "StackConfig"):
+    from llama_toolchain.common.exec import run_command
+    from llama_toolchain.common.prompt_for_config import prompt_for_config
+    from llama_toolchain.common.serialize import EnumEncoder
+    from llama_toolchain.distribution.dynamic import instantiate_class_type
+
+    python_exe = run_command(shlex.split("which python"))
+    # simple check
+    conda_env = config.conda_env
+    if conda_env not in python_exe:
+        raise ValueError(
+            f"Please re-run configure by activating the `{conda_env}` conda environment"
+        )
+
+    if config.providers:
+        cprint(
+            f"Configuration already exists for {config.name}. Will overwrite...",
+            "yellow",
+            attrs=["bold"],
+        )
+
+    for api, provider_spec in dist.provider_specs.items():
+        cprint(f"Configuring API surface: {api.value}", "white", attrs=["bold"])
+        config_type = instantiate_class_type(provider_spec.config_class)
+        provider_config = prompt_for_config(
+            config_type,
+            (
+                config_type(**config.providers[api.value])
+                if api.value in config.providers
+                else None
+            ),
+        )
+        print("")
+
+        config.providers[api.value] = {
+            "provider_id": provider_spec.provider_id,
+            **provider_config.dict(),
+        }
+
+    config_path = DISTRIBS_BASE_DIR / config.name / "config.yaml"
+    with open(config_path, "w") as fp:
+        dist_config = json.loads(json.dumps(config.dict(), cls=EnumEncoder))
+        fp.write(yaml.dump(dist_config, sort_keys=False))
+
+    print(f"YAML configuration has been written to {config_path}")

llama_toolchain/cli/stack/create.py

@@ -0,0 +1,43 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+import argparse
+
+from llama_toolchain.cli.subcommand import Subcommand
+
+
+class StackCreate(Subcommand):
+    def __init__(self, subparsers: argparse._SubParsersAction):
+        super().__init__()
+        self.parser = subparsers.add_parser(
+            "create",
+            prog="llama distribution create",
+            description="create a Llama stack distribution",
+            formatter_class=argparse.RawTextHelpFormatter,
+        )
+        self._add_arguments()
+        self.parser.set_defaults(func=self._run_distribution_create_cmd)
+
+    def _add_arguments(self):
+        self.parser.add_argument(
+            "--name",
+            type=str,
+            help="Name of the distribution to create",
+            required=True,
+        )
+        # for each Api the user wants to support, we should
+        # get the list of available providers, ask which one the user
+        # wants to pick and then ask for their configuration.
+
+    def _run_distribution_create_cmd(self, args: argparse.Namespace) -> None:
+        from llama_toolchain.distribution.registry import resolve_distribution_spec
+
+        dist = resolve_distribution_spec(args.name)
+        if dist is not None:
+            self.parser.error(f"Stack with name {args.name} already exists")
+            return
+
+        raise NotImplementedError()

llama_toolchain/cli/stack/install.py

@@ -0,0 +1,111 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+import argparse
+import os
+
+import pkg_resources
+import yaml
+
+from termcolor import cprint
+
+from llama_toolchain.cli.subcommand import Subcommand
+from llama_toolchain.common.config_dirs import DISTRIBS_BASE_DIR
+
+
+class StackInstall(Subcommand):
+    """Llama cli for configuring llama toolchain configs"""
+
+    def __init__(self, subparsers: argparse._SubParsersAction):
+        super().__init__()
+        self.parser = subparsers.add_parser(
+            "install",
+            prog="llama distribution install",
+            description="Install a llama stack distribution",
+            formatter_class=argparse.RawTextHelpFormatter,
+        )
+        self._add_arguments()
+        self.parser.set_defaults(func=self._run_distribution_install_cmd)
+
+    def _add_arguments(self):
+        from llama_toolchain.distribution.registry import available_distribution_specs
+
+        self.parser.add_argument(
+            "--spec",
+            type=str,
+            help="Stack spec to install (try local-ollama)",
+            required=True,
+            choices=[d.spec_id for d in available_distribution_specs()],
+        )
+        self.parser.add_argument(
+            "--name",
+            type=str,
+            help="What should the installation be called locally?",
+            required=True,
+        )
+        self.parser.add_argument(
+            "--conda-env",
+            type=str,
+            help="conda env in which this distribution will run (default = distribution name)",
+        )
+
+    def _run_distribution_install_cmd(self, args: argparse.Namespace) -> None:
+        from llama_toolchain.common.exec import run_with_pty
+        from llama_toolchain.distribution.datatypes import StackConfig
+        from llama_toolchain.distribution.distribution import distribution_dependencies
+        from llama_toolchain.distribution.registry import resolve_distribution_spec
+
+        os.makedirs(DISTRIBS_BASE_DIR, exist_ok=True)
+        script = pkg_resources.resource_filename(
+            "llama_toolchain",
+            "distribution/install_distribution.sh",
+        )
+
+        dist = resolve_distribution_spec(args.spec)
+        if dist is None:
+            self.parser.error(f"Could not find distribution {args.spec}")
+            return
+
+        distrib_dir = DISTRIBS_BASE_DIR / args.name
+        os.makedirs(distrib_dir, exist_ok=True)
+
+        deps = distribution_dependencies(dist)
+        if not args.conda_env:
+            print(f"Using {args.name} as the Conda environment for this distribution")
+
+        conda_env = args.conda_env or args.name
+
+        config_file = distrib_dir / "config.yaml"
+        if config_file.exists():
+            c = StackConfig(**yaml.safe_load(config_file.read_text()))
+            if c.spec != dist.spec_id:
+                self.parser.error(
+                    f"already installed distribution with `spec={c.spec}` does not match provided spec `{args.spec}`"
+                )
+                return
+            if c.conda_env != conda_env:
+                self.parser.error(
+                    f"already installed distribution has `conda_env={c.conda_env}` different from provided conda env `{conda_env}`"
+                )
+                return
+        else:
+            with open(config_file, "w") as f:
+                c = StackConfig(
+                    spec=dist.spec_id,
+                    name=args.name,
+                    conda_env=conda_env,
+                )
+                f.write(yaml.dump(c.dict(), sort_keys=False))
+
+        return_code = run_with_pty([script, conda_env, args.name, " ".join(deps)])
+
+        assert return_code == 0, cprint(
+            f"Failed to install distribution {dist.spec_id}", color="red"
+        )
+        cprint(
+            f"Stack `{args.name}` (with spec {dist.spec_id}) has been installed successfully!",
+            color="green",
+        )

llama_toolchain/cli/stack/list.py

@@ -0,0 +1,53 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+import argparse
+import json
+
+from llama_toolchain.cli.subcommand import Subcommand
+
+
+class StackList(Subcommand):
+    def __init__(self, subparsers: argparse._SubParsersAction):
+        super().__init__()
+        self.parser = subparsers.add_parser(
+            "list",
+            prog="llama distribution list",
+            description="Show available llama stack distributions",
+            formatter_class=argparse.RawTextHelpFormatter,
+        )
+        self._add_arguments()
+        self.parser.set_defaults(func=self._run_distribution_list_cmd)
+
+    def _add_arguments(self):
+        pass
+
+    def _run_distribution_list_cmd(self, args: argparse.Namespace) -> None:
+        from llama_toolchain.cli.table import print_table
+        from llama_toolchain.distribution.registry import available_distribution_specs
+
+        # eventually, this should query a registry at llama.meta.com/llamastack/distributions
+        headers = [
+            "Spec ID",
+            "ProviderSpecs",
+            "Description",
+        ]
+
+        rows = []
+        for spec in available_distribution_specs():
+            providers = {k.value: v.provider_id for k, v in spec.provider_specs.items()}
+            rows.append(
+                [
+                    spec.spec_id,
+                    json.dumps(providers, indent=2),
+                    spec.description,
+                ]
+            )
+        print_table(
+            rows,
+            headers,
+            separate_rows=True,
+        )

llama_toolchain/cli/stack/stack.py

@@ -0,0 +1,34 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+import argparse
+
+from llama_toolchain.cli.subcommand import Subcommand
+
+from .configure import StackConfigure
+from .create import StackCreate
+from .install import StackInstall
+from .list import StackList
+from .start import StackStart
+
+
+class StackParser(Subcommand):
+    def __init__(self, subparsers: argparse._SubParsersAction):
+        super().__init__()
+        self.parser = subparsers.add_parser(
+            "distribution",
+            prog="llama distribution",
+            description="Operate on llama stack distributions",
+        )
+
+        subparsers = self.parser.add_subparsers(title="distribution_subcommands")
+
+        # Add sub-commands
+        StackList.create(subparsers)
+        StackInstall.create(subparsers)
+        StackCreate.create(subparsers)
+        StackConfigure.create(subparsers)
+        StackStart.create(subparsers)

llama_toolchain/cli/stack/start.py

@@ -0,0 +1,81 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+#
+# This source code is licensed under the terms described in the LICENSE file in
+# the root directory of this source tree.
+
+import argparse
+
+import pkg_resources
+import yaml
+
+from llama_toolchain.cli.subcommand import Subcommand
+from llama_toolchain.common.config_dirs import DISTRIBS_BASE_DIR
+
+
+class StackStart(Subcommand):
+    def __init__(self, subparsers: argparse._SubParsersAction):
+        super().__init__()
+        self.parser = subparsers.add_parser(
+            "start",
+            prog="llama distribution start",
+            description="""start the server for a Llama stack distribution. you should have already installed and configured the distribution""",
+            formatter_class=argparse.RawTextHelpFormatter,
+        )
+        self._add_arguments()
+        self.parser.set_defaults(func=self._run_distribution_start_cmd)
+
+    def _add_arguments(self):
+        self.parser.add_argument(
+            "--name",
+            type=str,
+            help="Name of the distribution to start",
+            required=True,
+        )
+        self.parser.add_argument(
+            "--port",
+            type=int,
+            help="Port to run the server on. Defaults to 5000",
+            default=5000,
+        )
+        self.parser.add_argument(
+            "--disable-ipv6",
+            action="store_true",
+            help="Disable IPv6 support",
+            default=False,
+        )
+
+    def _run_distribution_start_cmd(self, args: argparse.Namespace) -> None:
+        from llama_toolchain.common.exec import run_with_pty
+        from llama_toolchain.distribution.registry import resolve_distribution_spec
+
+        config_file = DISTRIBS_BASE_DIR / args.name / "config.yaml"
+        if not config_file.exists():
+            self.parser.error(
+                f"Could not find {config_file}. Please run `llama distribution install` first"
+            )
+            return
+
+        # we need to find the spec from the name
+        with open(config_file, "r") as f:
+            config = yaml.safe_load(f)
+
+        dist = resolve_distribution_spec(config["spec"])
+        if dist is None:
+            raise ValueError(f"Could not find any registered spec `{config['spec']}`")
+
+        conda_env = config["conda_env"]
+        if not conda_env:
+            raise ValueError(
+                f"Could not find Conda environment for distribution `{args.name}`"
+            )
+
+        script = pkg_resources.resource_filename(
+            "llama_toolchain",
+            "distribution/start_distribution.sh",
+        )
+        args = [script, conda_env, config_file, "--port", str(args.port)] + (
+            ["--disable-ipv6"] if args.disable_ipv6 else []
+        )
+
+        run_with_pty(args)