blue-assistant 4.104.1__tar.gz → 4.137.1__tar.gz

{blue_assistant-4.104.1/blue_assistant.egg-info → blue_assistant-4.137.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: blue_assistant
-Version: 4.104.1
+Version: 4.137.1
 Summary: 🧠 An AI Assistant.
 Home-page: https://github.com/kamangir/blue-assistant
 Author: Arash Abadpour (Kamangir)
@@ -44,7 +44,11 @@ Dynamic: summary
 
 # 🧠 blue-assistant
 
-🧠 `@assistant` is an AI assistant.
+🧠 `@assistant` runs AI scripts; DAGs that combine deterministic and AI operations, such as below,
+
+|   |   |
+| --- | --- |
+| [`orbital-data-explorer`](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/orbital_data_explorer/README.md) [![image](https://github.com/kamangir/assets/raw/main/blue-plugin/marquee.png?raw=true)](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/orbital_data_explorer/README.md) Access to the [Orbital Data Explorer](https://ode.rsl.wustl.edu/), through AI. | [`blue-amo`](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/blue_amo/README.md) [![image](https://github.com/kamangir/assets/raw/main/blue-amo-2025-02-03-nswnx6/stitching_the_frames-2.png?raw=true)](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/blue_amo/README.md) A story developed and visualized, by AI. |
 
 ```bash
 pip install blue-assistant
@@ -72,4 +76,4 @@ graph LR
 
 [![pylint](https://github.com/kamangir/blue-assistant/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/blue-assistant/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/blue-assistant/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/blue-assistant.svg)](https://pypi.org/project/blue-assistant/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/blue-assistant)](https://pypistats.org/packages/blue-assistant)
 
-built by 🌀 [`blue_options-4.207.1`](https://github.com/kamangir/awesome-bash-cli), based on 🧠 [`blue_assistant-4.104.1`](https://github.com/kamangir/blue-assistant).
+built by 🌀 [`blue_options-4.207.1`](https://github.com/kamangir/awesome-bash-cli), based on 🧠 [`blue_assistant-4.137.1`](https://github.com/kamangir/blue-assistant).

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/README.md

@@ -1,6 +1,10 @@
 # 🧠 blue-assistant
 
-🧠 `@assistant` is an AI assistant.
+🧠 `@assistant` runs AI scripts; DAGs that combine deterministic and AI operations, such as below,
+
+|   |   |
+| --- | --- |
+| [`orbital-data-explorer`](./blue_assistant/script/repository/orbital_data_explorer/README.md) [![image](https://github.com/kamangir/assets/raw/main/blue-plugin/marquee.png?raw=true)](./blue_assistant/script/repository/orbital_data_explorer/README.md) Access to the [Orbital Data Explorer](https://ode.rsl.wustl.edu/), through AI. | [`blue-amo`](./blue_assistant/script/repository/blue_amo/README.md) [![image](https://github.com/kamangir/assets/raw/main/blue-amo-2025-02-03-nswnx6/stitching_the_frames-2.png?raw=true)](./blue_assistant/script/repository/blue_amo/README.md) A story developed and visualized, by AI. |
 
 ```bash
 pip install blue-assistant
@@ -28,4 +32,4 @@ graph LR
 
 [![pylint](https://github.com/kamangir/blue-assistant/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/blue-assistant/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/blue-assistant/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/blue-assistant.svg)](https://pypi.org/project/blue-assistant/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/blue-assistant)](https://pypistats.org/packages/blue-assistant)
 
-built by 🌀 [`blue_options-4.207.1`](https://github.com/kamangir/awesome-bash-cli), based on 🧠 [`blue_assistant-4.104.1`](https://github.com/kamangir/blue-assistant).
+built by 🌀 [`blue_options-4.207.1`](https://github.com/kamangir/awesome-bash-cli), based on 🧠 [`blue_assistant-4.137.1`](https://github.com/kamangir/blue-assistant).

blue_assistant-4.137.1/blue_assistant/README.py

@@ -0,0 +1,48 @@
+import os
+
+from blue_objects import file, README
+
+from blue_assistant import NAME, VERSION, ICON, REPO_NAME
+
+
+items = [
+    "[`{}`]({}) [![image]({})]({}) {}".format(
+        item["title"],
+        item["url"],
+        item["marquee"],
+        item["url"],
+        item["description"],
+    )
+    for item in [
+        {
+            "title": "orbital-data-explorer",
+            "url": "./blue_assistant/script/repository/orbital_data_explorer/README.md",
+            "marquee": "https://github.com/kamangir/assets/raw/main/blue-plugin/marquee.png?raw=true",
+            "description": "Access to the [Orbital Data Explorer](https://ode.rsl.wustl.edu/), through AI.",
+        },
+        {
+            "title": "blue-amo",
+            "url": "./blue_assistant/script/repository/blue_amo/README.md",
+            "marquee": "https://github.com/kamangir/assets/raw/main/blue-amo-2025-02-03-nswnx6/stitching_the_frames-2.png?raw=true",
+            "description": "A story developed and visualized, by AI.",
+        },
+    ]
+]
+
+
+def build():
+    return all(
+        README.build(
+            items=readme.get("items", []),
+            path=os.path.join(file.path(__file__), readme["path"]),
+            ICON=ICON,
+            NAME=NAME,
+            VERSION=VERSION,
+            REPO_NAME=REPO_NAME,
+        )
+        for readme in [
+            {"items": items, "path": ".."},
+            {"path": "script/repository/blue_amo"},
+            {"path": "script/repository/orbital_data_explorer"},
+        ]
+    )

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/blue_assistant/__init__.py

@@ -4,7 +4,7 @@ ICON = "🧠"
 
 DESCRIPTION = f"{ICON} An AI Assistant."
 
-VERSION = "4.104.1"
+VERSION = "4.137.1"
 
 REPO_NAME = "blue-assistant"
 

blue_assistant-4.137.1/blue_assistant/script/actions/__init__.py

@@ -0,0 +1,16 @@
+from typing import Dict, Callable, Tuple
+
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.script.actions.generic import generic_action
+from blue_assistant.script.actions.generate_image import generate_image
+from blue_assistant.script.actions.generate_text import generate_text
+from blue_assistant.script.actions.skip import skip_action
+from blue_assistant.logger import logger
+
+
+dict_of_actions: Dict[str, Callable[[BaseScript, str], bool]] = {
+    "generic_action": generic_action,
+    "generate_image": generate_image,
+    "generate_text": generate_text,
+    "skip": skip_action,
+}

blue_assistant-4.137.1/blue_assistant/script/actions/generate_image.py

@@ -0,0 +1,52 @@
+from blueness import module
+from blue_objects import objects
+from openai_commands.image_generation.api import OpenAIImageGenerator
+
+from blue_assistant import NAME
+from blue_assistant.env import (
+    BLUE_ASSISTANT_IMAGE_DEFAULT_MODEL,
+    BLUE_ASSISTANT_IMAGE_DEFAULT_SIZE,
+    BLUE_ASSISTANT_IMAGE_DEFAULT_QUALITY,
+)
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+
+# https://platform.openai.com/docs/guides/images
+def generate_image(
+    script: BaseScript,
+    node_name: str,
+) -> bool:
+    logger.info(f"{NAME}: {script} @ {node_name} ...")
+
+    generator = OpenAIImageGenerator(
+        model=BLUE_ASSISTANT_IMAGE_DEFAULT_MODEL,
+        verbose=script.verbose,
+    )
+
+    filename = f"{node_name}.png"
+
+    success = generator.generate(
+        prompt=script.nodes[node_name]["prompt"],
+        filename=objects.path_of(
+            filename=filename,
+            object_name=script.object_name,
+            create=True,
+        ),
+        quality=(BLUE_ASSISTANT_IMAGE_DEFAULT_QUALITY if script.test_mode else "hd"),
+        size=(BLUE_ASSISTANT_IMAGE_DEFAULT_SIZE if script.test_mode else "1792x1024"),
+        sign_with_prompt=False,
+        footer=[
+            script.nodes[node_name].get(
+                "summary_prompt",
+                script.nodes[node_name]["prompt"],
+            )
+        ],
+    )[0]
+
+    if success:
+        script.nodes[node_name]["filename"] = filename
+
+    return success

blue_assistant-4.137.1/blue_assistant/script/actions/generate_text.py

@@ -0,0 +1,85 @@
+from typing import List
+from openai import OpenAI
+import pprint
+
+from blueness import module
+from openai_commands.env import OPENAI_API_KEY
+
+from blue_assistant import NAME
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.env import (
+    BLUE_ASSISTANT_TEXT_DEFAULT_MODEL,
+    BLUE_ASSISTANT_TEXT_MAX_TOKEN,
+)
+from blue_assistant.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+
+# https://platform.openai.com/docs/guides/text-generation
+def generate_text(
+    script: BaseScript,
+    node_name: str,
+) -> bool:
+    if not OPENAI_API_KEY:
+        logger.error("OPENAI_API_KEY is not set.")
+        return False
+
+    logger.info(f"{NAME}: {script} @ {node_name} ...")
+
+    messages: List = []
+    list_of_context_nodes = script.get_history(node_name)
+    logger.info("node context: {}".format(" <- ".join(list_of_context_nodes)))
+    for context_node in reversed(list_of_context_nodes):
+        messages += [
+            {
+                "role": "user",
+                "content": [
+                    {
+                        "type": "text",
+                        "text": script.apply_vars(script.nodes[context_node]["prompt"]),
+                    }
+                ],
+            }
+        ]
+
+        if script.nodes[context_node].get("completed", False):
+            messages += [
+                {
+                    "role": "assistant",
+                    "content": [
+                        {
+                            "type": "text",
+                            "text": script.nodes[context_node]["output"],
+                        }
+                    ],
+                }
+            ]
+
+    if script.verbose:
+        logger.info(f"messages: {pprint.pformat(messages)}")
+
+    client = OpenAI(api_key=OPENAI_API_KEY)
+
+    try:
+        response = client.chat.completions.create(
+            messages=messages,
+            model=BLUE_ASSISTANT_TEXT_DEFAULT_MODEL,
+            max_tokens=BLUE_ASSISTANT_TEXT_MAX_TOKEN,
+        )
+    except Exception as e:
+        logger.error(str(e))
+        return False
+
+    if script.verbose:
+        logger.info("response: {}".format(response))
+
+    if not response.choices:
+        logger.error("no choice.")
+        return False
+
+    output = response.choices[0].message.content
+    logger.info(f"🗣️ output: {output}")
+    script.nodes[node_name]["output"] = output
+
+    return True

blue_assistant-4.137.1/blue_assistant/script/actions/generic.py

@@ -0,0 +1,15 @@
+from blueness import module
+
+from blue_assistant import NAME
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+
+def generic_action(
+    script: BaseScript,
+    node_name: str,
+) -> bool:
+    logger.info(f"{NAME}: {script} @ {node_name} ...")
+    return True

blue_assistant-4.137.1/blue_assistant/script/actions/skip.py

@@ -0,0 +1,15 @@
+from blueness import module
+
+from blue_assistant import NAME
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+
+def skip_action(
+    script: BaseScript,
+    node_name: str,
+) -> bool:
+    logger.info(f"{NAME}: {script} @ {node_name} ...")
+    return True

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/blue_assistant/script/repository/__init__.py

@@ -3,13 +3,15 @@ from typing import List, Type
 from blue_assistant.script.repository.generic.classes import GenericScript
 from blue_assistant.script.repository.blue_amo.classes import BlueAmoScript
 from blue_assistant.script.repository.hue.classes import HueScript
-from blue_assistant.script.repository.moon_datasets.classes import MiningOnMoonScript
+from blue_assistant.script.repository.orbital_data_explorer.classes import (
+    OrbitalDataExplorerScript,
+)
 
 list_of_script_classes: List[Type[GenericScript]] = [
     GenericScript,
     BlueAmoScript,
     HueScript,
-    MiningOnMoonScript,
+    OrbitalDataExplorerScript,
 ]
 
 list_of_script_names: List[str] = [

blue_assistant-4.137.1/blue_assistant/script/repository/base/classes.py

@@ -0,0 +1,137 @@
+from typing import Dict, List
+import os
+import networkx as nx
+from functools import reduce
+
+from blueness import module
+from blue_objects import file, objects
+from blue_objects.metadata import post_to_object
+from blueflow.workflow import dot_file
+
+from blue_assistant import NAME
+from blue_assistant.logger import logger
+
+
+NAME = module.name(__file__, NAME)
+
+
+class BaseScript:
+    name = "base"
+
+    def __init__(
+        self,
+        object_name: str,
+        test_mode: bool = False,
+        verbose: bool = False,
+    ):
+        self.object_name = object_name
+
+        self.test_mode = test_mode
+        if self.test_mode:
+            logger.info("💰 test mode is on.")
+
+        self.verbose = verbose
+
+        metadata_filename = os.path.join(
+            file.path(__file__),
+            f"../{self.name}",
+            "metadata.yaml",
+        )
+        self.metadata: Dict
+        success, self.metadata = file.load_yaml(metadata_filename)
+        assert success, f"cannot load {self.name}/metadata.yaml"
+
+        logger.info("loaded {} node(s)".format(len(self.nodes)))
+
+        logger.info("loaded {} variable(s)".format(len(self.vars)))
+        if verbose:
+            for var_name, var_value in self.vars.items():
+                logger.info("{}: {}".format(var_name, var_value))
+
+        assert self.generate_graph(), "cannot generate graph"
+
+    def apply_vars(self, text: str) -> str:
+        for var_name, var_value in self.vars.items():
+            text = text.replace(f":::{var_name}", str(var_value))
+
+        return text
+
+    def generate_graph(self) -> bool:
+        self.G: nx.DiGraph = nx.DiGraph()
+
+        list_of_nodes = list(self.nodes.keys())
+        for node in self.nodes.values():
+            list_of_nodes += node.get("depends-on", "").split(",")
+
+        list_of_nodes = list({node_name for node_name in list_of_nodes if node_name})
+        logger.info(
+            "{} node(s): {}".format(
+                len(list_of_nodes),
+                ", ".join(list_of_nodes),
+            )
+        )
+
+        for node_name in list_of_nodes:
+            self.G.add_node(node_name)
+
+        for node_name, node in self.nodes.items():
+            for dependency in node.get("depends-on", "").split(","):
+                if dependency:
+                    self.G.add_edge(node_name, dependency)
+
+        return self.save_graph()
+
+    def get_history(
+        self,
+        node_name: str,
+    ) -> List[str]:
+        return reduce(
+            lambda x, y: x + y,
+            [self.get_history(successor) for successor in self.G.successors(node_name)],
+            [node_name],
+        )
+
+    def run(self) -> bool:
+        logger.info(
+            "{}.run: {}:{} -> {}".format(
+                NAME,
+                self.__class__.__name__,
+                self.name,
+                self.object_name,
+            )
+        )
+
+        return post_to_object(
+            self.object_name,
+            "script",
+            self.script,
+        )
+
+    def save_graph(self) -> bool:
+        return dot_file.save_to_file(
+            objects.path_of(
+                filename="workflow.dot",
+                object_name=self.object_name,
+            ),
+            self.G,
+            caption=" | ".join(
+                [
+                    self.name,
+                    self.object_name,
+                ]
+            ),
+            add_legend=False,
+        )
+
+    # Aliases
+    @property
+    def script(self) -> Dict:
+        return self.metadata.get("script", {})
+
+    @property
+    def nodes(self) -> Dict[str, Dict]:
+        return self.metadata.get("script", {}).get("nodes", {})
+
+    @property
+    def vars(self) -> Dict:
+        return self.metadata.get("script", {}).get("vars", {})

blue_assistant-4.137.1/blue_assistant/script/repository/blue_amo/actions/__init__.py

@@ -0,0 +1,13 @@
+from typing import Dict, Callable
+
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.script.repository.blue_amo.actions import (
+    slicing_into_frames,
+    stitching_the_frames,
+)
+
+
+dict_of_actions: Dict[str, Callable[[BaseScript, str], bool]] = {
+    "slicing_into_frames": slicing_into_frames.slicing_into_frames,
+    "stitching_the_frames": stitching_the_frames.stitching_the_frames,
+}

blue_assistant-4.104.1/blue_assistant/script/repository/blue_amo/actions/slice_into_frames.py → blue_assistant-4.137.1/blue_assistant/script/repository/blue_amo/actions/slicing_into_frames.py

@@ -7,7 +7,7 @@ from blue_assistant.logger import logger
 NAME = module.name(__file__, NAME)
 
 
-def slice_into_frames(
+def slicing_into_frames(
     script: BaseScript,
     node_name: str,
 ) -> bool:
@@ -25,11 +25,13 @@ def slice_into_frames(
     list_of_frame_prompts += script.vars["frame_count"] * [""]
 
     for index in range(script.vars["frame_count"]):
-        node_name = f"generating-frame-{index+1:03d}"
+        node_name = f"generating_frame_{index+1:03d}"
+
+        script.nodes[node_name]["summary_prompt"] = list_of_frame_prompts[index]
 
         script.nodes[node_name]["prompt"] = (
             script.nodes[node_name]["prompt"]
-            .replace(":::story", script.nodes["generating-the-story"]["output"])
+            .replace(":::story", " ".join(list_of_frame_prompts[:index]))
             .replace(":::input", list_of_frame_prompts[index])
         )
 

blue_assistant-4.104.1/blue_assistant/script/repository/blue_amo/actions/stitch_the_frames.py → blue_assistant-4.137.1/blue_assistant/script/repository/blue_amo/actions/stitching_the_frames.py

@@ -15,7 +15,7 @@ from blue_assistant.logger import logger
 NAME = module.name(__file__, NAME)
 
 
-def stitch_the_frames(
+def stitching_the_frames(
     script: BaseScript,
     node_name: str,
 ) -> bool:
@@ -24,7 +24,7 @@ def stitch_the_frames(
         for filename in [
             script.nodes[node_name_].get("filename", "")
             for node_name_ in [
-                f"generating-frame-{index+1:03d}"
+                f"generating_frame_{index+1:03d}"
                 for index in range(script.vars["frame_count"])
             ]
         ]

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/blue_assistant/script/repository/blue_amo/classes.py

@@ -5,12 +5,7 @@ from blue_objects import file, path
 
 from blue_assistant import NAME
 from blue_assistant.script.repository.generic.classes import GenericScript
-from blue_assistant.script.repository.blue_amo.actions.slice_into_frames import (
-    slice_into_frames,
-)
-from blue_assistant.script.repository.blue_amo.actions.stitch_the_frames import (
-    stitch_the_frames,
-)
+from blue_assistant.script.repository.blue_amo.actions import dict_of_actions
 from blue_assistant.logger import logger
 
 NAME = module.name(__file__, NAME)
@@ -34,7 +29,7 @@ class BlueAmoScript(GenericScript):
         if self.test_mode:
             self.vars["frame_count"] = 1
 
-        holder_node_name = "generating-the-frames"
+        holder_node_name = "generating_the_frames"
         logger.info(
             "{}: expanding {} X {}...".format(
                 NAME,
@@ -47,19 +42,19 @@ class BlueAmoScript(GenericScript):
         del self.nodes[holder_node_name]
         self.G.remove_node(holder_node_name)
 
-        reduce_node = "stitching-the-frames"
+        reduce_node = "stitching_the_frames"
         self.G.add_node(reduce_node)
         self.nodes[reduce_node] = {"action": "skip"}
 
         for index in range(self.vars["frame_count"]):
-            node_name = f"generating-frame-{index+1:03d}"
+            node_name = f"generating_frame_{index+1:03d}"
 
             self.nodes[node_name] = copy.deepcopy(holder_node)
 
             self.G.add_node(node_name)
             self.G.add_edge(
                 node_name,
-                "slicing-into-frames",
+                "slicing_into_frames",
             )
             self.G.add_edge(
                 reduce_node,
@@ -75,14 +70,8 @@ class BlueAmoScript(GenericScript):
         if not super().perform_action(node_name=node_name):
             return False
 
-        if node_name == "slicing-into-frames":
-            return slice_into_frames(
-                script=self,
-                node_name=node_name,
-            )
-
-        if node_name == "stitching-the-frames":
-            return stitch_the_frames(
+        if node_name in dict_of_actions:
+            return dict_of_actions[node_name](
                 script=self,
                 node_name=node_name,
             )

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/blue_assistant/script/repository/generic/classes.py

@@ -9,7 +9,7 @@ from blue_objects.metadata import post_to_object
 
 from blue_assistant import NAME
 from blue_assistant.script.repository.base.classes import BaseScript
-from blue_assistant.script.actions.functions import get_action_class
+from blue_assistant.script.actions import dict_of_actions
 from blue_assistant.logger import logger
 
 
@@ -24,25 +24,15 @@ class GenericScript(BaseScript):
         node_name: str,
     ) -> bool:
         action_name = self.nodes[node_name].get("action", "unknown")
-        if action_name == "skip":
-            return True
-
-        success, action_class = get_action_class(action_name=action_name)
-        if not success:
-            return success
-
-        logger.info(
-            "{}.perform_action: {} == {} on {}".format(
-                NAME,
-                action_name,
-                action_class.__name__,
-                node_name,
-            )
-        )
 
-        action_object = action_class(script=self)
+        if action_name not in dict_of_actions:
+            logger.error(f"{action_name}: action not found.")
+            return False
 
-        return action_object.perform(node_name=node_name)
+        return dict_of_actions[action_name](
+            script=self,
+            node_name=node_name,
+        )
 
     def run(
         self,

blue_assistant-4.137.1/blue_assistant/script/repository/hue/__init__.py

@@ -0,0 +1 @@
+from blue_assistant.script.repository.blue_amo.classes import BlueAmoScript

{blue_assistant-4.104.1/blue_assistant/script/repository/moon_datasets → blue_assistant-4.137.1/blue_assistant/script/repository/hue}/classes.py

@@ -3,5 +3,5 @@ from blue_objects import file, path
 from blue_assistant.script.repository.generic.classes import GenericScript
 
 
-class MiningOnMoonScript(GenericScript):
+class HueScript(GenericScript):
     name = path.name(file.path(__file__))

blue_assistant-4.137.1/blue_assistant/script/repository/orbital_data_explorer/__init__.py

@@ -0,0 +1,3 @@
+from blue_assistant.script.repository.orbital_data_explorer.classes import (
+    OrbitalDataExplorerScript,
+)

blue_assistant-4.137.1/blue_assistant/script/repository/orbital_data_explorer/actions/__init__.py

@@ -0,0 +1,11 @@
+from typing import Dict, Callable
+
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.script.repository.orbital_data_explorer.actions import (
+    researching_the_questions,
+)
+
+
+dict_of_actions: Dict[str, Callable[[BaseScript, str], bool]] = {
+    "researching_the_questions": researching_the_questions.researching_the_questions,
+}

blue_assistant-4.137.1/blue_assistant/script/repository/orbital_data_explorer/actions/researching_the_questions.py

@@ -0,0 +1,18 @@
+from blueness import module
+
+from blue_assistant import NAME
+from blue_assistant.script.repository.base.classes import BaseScript
+from blue_assistant.logger import logger
+
+NAME = module.name(__file__, NAME)
+
+
+def researching_the_questions(
+    script: BaseScript,
+    node_name: str,
+) -> bool:
+    logger.info(f"{NAME}: ...")
+
+    logger.info("🪄")
+
+    return True

blue_assistant-4.137.1/blue_assistant/script/repository/orbital_data_explorer/classes.py

@@ -0,0 +1,25 @@
+from blue_objects import file, path
+
+from blue_assistant.script.repository.generic.classes import GenericScript
+from blue_assistant.script.repository.orbital_data_explorer.actions import (
+    dict_of_actions,
+)
+
+
+class OrbitalDataExplorerScript(GenericScript):
+    name = path.name(file.path(__file__))
+
+    def perform_action(
+        self,
+        node_name: str,
+    ) -> bool:
+        if not super().perform_action(node_name=node_name):
+            return False
+
+        if node_name in dict_of_actions:
+            return dict_of_actions[node_name](
+                script=self,
+                node_name=node_name,
+            )
+
+        return True

{blue_assistant-4.104.1 → blue_assistant-4.137.1/blue_assistant.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: blue_assistant
-Version: 4.104.1
+Version: 4.137.1
 Summary: 🧠 An AI Assistant.
 Home-page: https://github.com/kamangir/blue-assistant
 Author: Arash Abadpour (Kamangir)
@@ -44,7 +44,11 @@ Dynamic: summary
 
 # 🧠 blue-assistant
 
-🧠 `@assistant` is an AI assistant.
+🧠 `@assistant` runs AI scripts; DAGs that combine deterministic and AI operations, such as below,
+
+|   |   |
+| --- | --- |
+| [`orbital-data-explorer`](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/orbital_data_explorer/README.md) [![image](https://github.com/kamangir/assets/raw/main/blue-plugin/marquee.png?raw=true)](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/orbital_data_explorer/README.md) Access to the [Orbital Data Explorer](https://ode.rsl.wustl.edu/), through AI. | [`blue-amo`](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/blue_amo/README.md) [![image](https://github.com/kamangir/assets/raw/main/blue-amo-2025-02-03-nswnx6/stitching_the_frames-2.png?raw=true)](https://raw.githubusercontent.com/kamangir/blue-assistant/main/blue_assistant/script/repository/blue_amo/README.md) A story developed and visualized, by AI. |
 
 ```bash
 pip install blue-assistant
@@ -72,4 +76,4 @@ graph LR
 
 [![pylint](https://github.com/kamangir/blue-assistant/actions/workflows/pylint.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/pylint.yml) [![pytest](https://github.com/kamangir/blue-assistant/actions/workflows/pytest.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/pytest.yml) [![bashtest](https://github.com/kamangir/blue-assistant/actions/workflows/bashtest.yml/badge.svg)](https://github.com/kamangir/blue-assistant/actions/workflows/bashtest.yml) [![PyPI version](https://img.shields.io/pypi/v/blue-assistant.svg)](https://pypi.org/project/blue-assistant/) [![PyPI - Downloads](https://img.shields.io/pypi/dd/blue-assistant)](https://pypistats.org/packages/blue-assistant)
 
-built by 🌀 [`blue_options-4.207.1`](https://github.com/kamangir/awesome-bash-cli), based on 🧠 [`blue_assistant-4.104.1`](https://github.com/kamangir/blue-assistant).
+built by 🌀 [`blue_options-4.207.1`](https://github.com/kamangir/awesome-bash-cli), based on 🧠 [`blue_assistant-4.137.1`](https://github.com/kamangir/blue-assistant).

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/blue_assistant.egg-info/SOURCES.txt

@@ -40,18 +40,23 @@ blue_assistant/script/__init__.py
 blue_assistant/script/__main__.py
 blue_assistant/script/load.py
 blue_assistant/script/actions/__init__.py
-blue_assistant/script/actions/functions.py
 blue_assistant/script/actions/generate_image.py
 blue_assistant/script/actions/generate_text.py
 blue_assistant/script/actions/generic.py
-blue_assistant/script/actions/wip.py
+blue_assistant/script/actions/skip.py
 blue_assistant/script/repository/__init__.py
+blue_assistant/script/repository/base/__init__.py
+blue_assistant/script/repository/base/classes.py
 blue_assistant/script/repository/blue_amo/__init__.py
 blue_assistant/script/repository/blue_amo/classes.py
 blue_assistant/script/repository/blue_amo/actions/__init__.py
-blue_assistant/script/repository/blue_amo/actions/slice_into_frames.py
-blue_assistant/script/repository/blue_amo/actions/stitch_the_frames.py
+blue_assistant/script/repository/blue_amo/actions/slicing_into_frames.py
+blue_assistant/script/repository/blue_amo/actions/stitching_the_frames.py
 blue_assistant/script/repository/generic/__init__.py
 blue_assistant/script/repository/generic/classes.py
-blue_assistant/script/repository/moon_datasets/__init__.py
-blue_assistant/script/repository/moon_datasets/classes.py
+blue_assistant/script/repository/hue/__init__.py
+blue_assistant/script/repository/hue/classes.py
+blue_assistant/script/repository/orbital_data_explorer/__init__.py
+blue_assistant/script/repository/orbital_data_explorer/classes.py
+blue_assistant/script/repository/orbital_data_explorer/actions/__init__.py
+blue_assistant/script/repository/orbital_data_explorer/actions/researching_the_questions.py

{blue_assistant-4.104.1 → blue_assistant-4.137.1}/setup.py

@@ -13,10 +13,13 @@ setup(
         f"{NAME}.script",
         f"{NAME}.script.actions",
         f"{NAME}.script.repository",
+        f"{NAME}.script.repository.base",
         f"{NAME}.script.repository.blue_amo",
         f"{NAME}.script.repository.blue_amo.actions",
         f"{NAME}.script.repository.generic",
-        f"{NAME}.script.repository.moon_datasets",
+        f"{NAME}.script.repository.hue",
+        f"{NAME}.script.repository.orbital_data_explorer",
+        f"{NAME}.script.repository.orbital_data_explorer.actions",
     ],
     include_package_data=True,
     package_data={

blue_assistant-4.104.1/blue_assistant/README.py

@@ -1,33 +0,0 @@
-import os
-
-from blue_objects import file, README
-
-from blue_assistant import NAME, VERSION, ICON, REPO_NAME
-
-
-items = [
-    "{}[`{}`](#) [![image]({})](#) {}".format(
-        ICON,
-        f"feature {index}",
-        "https://github.com/kamangir/assets/raw/main/blue-assistant/marquee.png?raw=true",
-        f"description of feature {index} ...",
-    )
-    for index in range(1, 4)
-]
-
-
-def build():
-    return all(
-        README.build(
-            items=readme.get("items", []),
-            path=os.path.join(file.path(__file__), readme["path"]),
-            ICON=ICON,
-            NAME=NAME,
-            VERSION=VERSION,
-            REPO_NAME=REPO_NAME,
-        )
-        for readme in [
-            {"items": items, "path": ".."},
-            {"path": "docs/blue-amo.md"},
-        ]
-    )

blue_assistant-4.104.1/blue_assistant/script/actions/__init__.py

@@ -1,14 +0,0 @@
-from typing import List
-
-from blue_assistant.script.actions.generic import GenericAction
-from blue_assistant.script.actions.generate_image import GenerateImageAction
-from blue_assistant.script.actions.generate_text import GenerateTextAction
-from blue_assistant.script.actions.wip import WorkInProgressAction
-from blue_assistant.logger import logger
-
-list_of_actions: List[GenericAction] = [
-    GenericAction,
-    GenerateImageAction,
-    GenerateTextAction,
-    WorkInProgressAction,
-]

blue_assistant-4.104.1/blue_assistant/script/actions/functions.py

@@ -1,22 +0,0 @@
-from typing import List, Dict, Tuple, Type
-
-from blueness import module
-from blue_assistant.script.actions.generic import GenericAction
-from blue_assistant.script.repository.base.classes import BaseScript
-from blue_assistant.script.actions import list_of_actions
-
-from blue_assistant import NAME
-from blue_assistant.logger import logger
-
-NAME = module.name(__file__, NAME)
-
-
-def get_action_class(
-    action_name: str,
-) -> Tuple[bool, Type[GenericAction]]:
-    for action_class in list_of_actions:
-        if action_class.name == action_name:
-            return True, action_class
-
-    logger.error(f"{action_name}: action not found.")
-    return False, GenericAction

blue_assistant-4.104.1/blue_assistant/script/actions/generate_image.py

@@ -1,58 +0,0 @@
-from blue_objects import file, objects
-from openai_commands.image_generation.api import OpenAIImageGenerator
-
-from blue_assistant.env import (
-    BLUE_ASSISTANT_IMAGE_DEFAULT_MODEL,
-    BLUE_ASSISTANT_IMAGE_DEFAULT_SIZE,
-    BLUE_ASSISTANT_IMAGE_DEFAULT_QUALITY,
-)
-from blue_assistant.script.actions.generic import GenericAction
-from blue_assistant.script.repository.base.classes import BaseScript
-from blue_assistant.logger import logger
-
-
-class GenerateImageAction(GenericAction):
-    name = file.name(__file__)
-
-    def __init__(
-        self,
-        script: BaseScript,
-    ):
-        super().__init__(script=script)
-
-        self.generator = OpenAIImageGenerator(
-            model=BLUE_ASSISTANT_IMAGE_DEFAULT_MODEL,
-            verbose=self.script.verbose,
-        )
-
-    # https://platform.openai.com/docs/guides/images
-    def perform(
-        self,
-        node_name: str,
-    ) -> bool:
-        if not super().perform(node_name=node_name):
-            return False
-
-        filename = f"{node_name}.png"
-
-        success = self.generator.generate(
-            prompt=self.script.nodes[node_name]["prompt"],
-            filename=objects.path_of(
-                filename=filename,
-                object_name=self.script.object_name,
-                create=True,
-            ),
-            quality=(
-                BLUE_ASSISTANT_IMAGE_DEFAULT_QUALITY if self.script.test_mode else "hd"
-            ),
-            size=(
-                BLUE_ASSISTANT_IMAGE_DEFAULT_SIZE
-                if self.script.test_mode
-                else "1792x1024"
-            ),
-        )[0]
-
-        if success:
-            self.script.nodes[node_name]["filename"] = filename
-
-        return success

blue_assistant-4.104.1/blue_assistant/script/actions/generate_text.py

@@ -1,97 +0,0 @@
-from typing import Dict, Tuple, List
-from openai import OpenAI
-import pprint
-
-from blueness import module
-from blue_objects import file
-from openai_commands.env import OPENAI_API_KEY
-
-from blue_assistant import NAME
-from blue_assistant.env import (
-    BLUE_ASSISTANT_TEXT_DEFAULT_MODEL,
-    BLUE_ASSISTANT_TEXT_MAX_TOKEN,
-)
-from blue_assistant.script.actions.generic import GenericAction
-from blue_assistant.logger import logger
-
-NAME = module.name(__file__, NAME)
-
-
-class GenerateTextAction(GenericAction):
-    name = file.name(__file__)
-
-    # https://platform.openai.com/docs/guides/text-generation
-    def perform(
-        self,
-        node_name: str,
-    ) -> bool:
-        if not OPENAI_API_KEY:
-            logger.error("OPENAI_API_KEY is not set.")
-            return False
-
-        if not super().perform(node_name=node_name):
-            return False
-
-        messages: List = []
-        list_of_context_nodes = self.script.get_history(node_name)
-        logger.info("node context: {}".format(" <- ".join(list_of_context_nodes)))
-        for context_node in reversed(list_of_context_nodes):
-            messages += [
-                {
-                    "role": "user",
-                    "content": [
-                        {
-                            "type": "text",
-                            "text": self.script.apply_vars(
-                                self.script.nodes[context_node]["prompt"]
-                            ),
-                        }
-                    ],
-                }
-            ]
-
-            if self.script.nodes[context_node].get("completed", False):
-                messages += [
-                    {
-                        "role": "assistant",
-                        "content": [
-                            {
-                                "type": "text",
-                                "text": self.script.nodes[context_node]["output"],
-                            }
-                        ],
-                    }
-                ]
-
-        if self.script.verbose:
-            logger.info(f"messages: {pprint.pformat(messages)}")
-
-        client = OpenAI(api_key=OPENAI_API_KEY)
-
-        try:
-            response = client.chat.completions.create(
-                messages=messages,
-                model=BLUE_ASSISTANT_TEXT_DEFAULT_MODEL,
-                max_tokens=BLUE_ASSISTANT_TEXT_MAX_TOKEN,
-            )
-        except Exception as e:
-            logger.error(str(e))
-            return False
-
-        if self.script.verbose:
-            logger.info("response: {}".format(response))
-
-        if not response.choices:
-            logger.error("no choice.")
-            return False
-
-        output = response.choices[0].message.content
-        logger.info(f"🗣️ output: {output}")
-
-        self.script.nodes[node_name]["output"] = output
-
-        var_name = self.script.nodes[node_name].get("output", "")
-        if var_name:
-            self.script.vars[var_name] = output
-
-        return True

blue_assistant-4.104.1/blue_assistant/script/actions/generic.py

@@ -1,27 +0,0 @@
-from blue_objects import file
-
-from blue_assistant.script.repository.base.classes import BaseScript
-from blue_assistant.logger import logger
-
-
-class GenericAction:
-    name = file.name(__file__)
-
-    def __init__(
-        self,
-        script: BaseScript,
-    ):
-        self.script = script
-
-    def perform(
-        self,
-        node_name: str,
-    ) -> bool:
-        logger.info(
-            "{}.perform on {}.{} ...".format(
-                self.__class__.__name__,
-                self.script.name,
-                node_name,
-            ),
-        )
-        return True

blue_assistant-4.104.1/blue_assistant/script/actions/wip.py

@@ -1,7 +0,0 @@
-from blue_objects import file
-
-from blue_assistant.script.actions.generic import GenericAction
-
-
-class WorkInProgressAction(GenericAction):
-    name = file.name(__file__)

blue_assistant-4.104.1/blue_assistant/script/repository/moon_datasets/__init__.py

@@ -1 +0,0 @@
-from blue_assistant.script.repository.moon_datasets.classes import MiningOnMoonScript