modi-cogitandi 0.0.1__tar.gz

modi_cogitandi-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Alexander Fedotov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

modi_cogitandi-0.0.1/MANIFEST.in

@@ -0,0 +1 @@
+include src/modi_cogitandi/*.yaml

modi_cogitandi-0.0.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: modi-cogitandi
+Version: 0.0.1
+Summary: Modes of thought.
+Author-email: Machina Ratiocinatrix <machina.ratio@gmail.com>, Alexander Fedotov <alex.fedotov@aol.com>
+Project-URL: Homepage, https://github.com/modi-cogitandi/modi-cogitandi
+Keywords: modi-cogitandi
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml==6.0.3
+Dynamic: license-file
+
+# Modi-Cogitandi
+Modes of thought
+
+In order to launch it from the command line or as a Python subprocess:
+```bash
+echo "Theodotos-Alexandreus: What mode of thought should we use, machine?" \
+  | uvx modi-cogitandi \
+    --provider-api-key=sk-proj-... \
+    --github-token=ghp_... 
+```
+
+Or, with a local pip installation:
+```bash
+pip install modi-cogitandi
+```
+Set the environment variables:
+```bash
+export PROVIDER_API_KEY="sk-proj-..."
+export GITHUB_TOKEN="ghp_..."
+```
+Then:
+```bash
+modi-cogitandi multilogue.txt
+```
+Or:
+```bash
+modi-cogitandi multilogue.txt > output.txt
+```
+Or:
+```bash
+modi-cogitandi multilogue.txt > tmp && mv tmp multilogue.txt
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | modi-cogitandi
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | modi-cogitandi > tmp && mv tmp multilogue.txt
+```
+Or: 
+```bash
+(cat multilogue.txt; echo:"Theodotos: What do you think, Modi-Cogitandi?") \
+  | modi-cogitandi
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | modi-cogitandi > tmp && mv tmp multilogue.txt
+```
+Or, if you have installed other machines:
+```bash
+cat multilogue.md | modi-cogitandi \
+  | summarizing-machine | judging-machine > summary_judgment.md
+```
+
+Or use it in your Python code:
+```Python
+# Python
+import modi_cogitandi
+```

modi_cogitandi-0.0.1/README.md

@@ -0,0 +1,60 @@
+# Modi-Cogitandi
+Modes of thought
+
+In order to launch it from the command line or as a Python subprocess:
+```bash
+echo "Theodotos-Alexandreus: What mode of thought should we use, machine?" \
+  | uvx modi-cogitandi \
+    --provider-api-key=sk-proj-... \
+    --github-token=ghp_... 
+```
+
+Or, with a local pip installation:
+```bash
+pip install modi-cogitandi
+```
+Set the environment variables:
+```bash
+export PROVIDER_API_KEY="sk-proj-..."
+export GITHUB_TOKEN="ghp_..."
+```
+Then:
+```bash
+modi-cogitandi multilogue.txt
+```
+Or:
+```bash
+modi-cogitandi multilogue.txt > output.txt
+```
+Or:
+```bash
+modi-cogitandi multilogue.txt > tmp && mv tmp multilogue.txt
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | modi-cogitandi
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | modi-cogitandi > tmp && mv tmp multilogue.txt
+```
+Or: 
+```bash
+(cat multilogue.txt; echo:"Theodotos: What do you think, Modi-Cogitandi?") \
+  | modi-cogitandi
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | modi-cogitandi > tmp && mv tmp multilogue.txt
+```
+Or, if you have installed other machines:
+```bash
+cat multilogue.md | modi-cogitandi \
+  | summarizing-machine | judging-machine > summary_judgment.md
+```
+
+Or use it in your Python code:
+```Python
+# Python
+import modi_cogitandi
+```

modi_cogitandi-0.0.1/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools==82.0.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "modi-cogitandi"
+version = "0.0.1"
+authors = [
+    {name="Machina Ratiocinatrix", email="machina.ratio@gmail.com"},
+    {name="Alexander Fedotov", email="alex.fedotov@aol.com"}
+]
+description = "Modes of thought."
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+]
+keywords = ["modi-cogitandi"]
+dependencies = [
+    "pyyaml == 6.0.3"
+]
+
+[project.scripts]
+modi-cogitandi = "modi_cogitandi.cli:run"
+
+[project.urls]
+"Homepage" = "https://github.com/modi-cogitandi/modi-cogitandi"
+
+[dependency-groups]
+dev = ["pytest>=8.0.0"]

modi_cogitandi-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

modi_cogitandi-0.0.1/src/modi_cogitandi/__init__.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+from .config import Config
+from .main import machina
+from .githf import fetch_instructions
+from .utilities import (plato_text_to_muj,
+                        plato_text_to_mpuj,
+                        llm_soup_to_text,
+                        new_plato_text)
+
+__all__ = [
+    'machina',
+    'fetch_instructions',
+    'Config'
+]

modi_cogitandi-0.0.1/src/modi_cogitandi/cli.py

@@ -0,0 +1,151 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+import os
+import sys
+import select
+import fileinput
+import argparse
+import syslog
+from .config import Config
+from .utilities import new_plato_text
+
+
+def options_and_arguments():
+    parser = argparse.ArgumentParser(
+        description="Machina-Ratiocinatrix ratiocinates.",
+        epilog="Example:  machina input_text.txt > output_text.txt"
+    )
+
+    # Give the access key and token, or set the environment variables in advance.
+    parser.add_argument('-p', '--provider-api-key',
+                        default=os.getenv('PROVIDER_API_KEY', 'no_key'),
+                        help="LLM provider API key (defaults to $PROVIDER_API_KEY)")
+    parser.add_argument('-g', '--github-token',
+                        default=os.getenv('GITHUB_TOKEN', 'no_token'),
+                        help="GitHub API token (defaults to $GITHUB_TOKEN)")
+
+    parser.add_argument('-a', '--append',
+                        action='store_true',
+                        help="Append the proceeds to the input.")
+
+    parser.add_argument('-d', '--debug',
+                        action='store_true',
+                        help="Debug flag.")
+
+    parser.add_argument('-i', '--interactive',
+                        action='store_true',
+                        help="Enable interactive mode (defaults to False)")
+
+    # Positional arguments (files)
+    # '*' captures zero or more arguments into a list, nargs='+' one or more.
+    parser.add_argument('filenames',
+                        nargs='*',
+                        help="Zero (when text comes though a pipe) or more files to process.")
+    return parser
+
+
+def run():
+    """After installation, on Linux prompt
+    $ machina file1.txt file2.txt > output.txt
+    """
+    args = options_and_arguments().parse_args()
+
+    # If no files are provided AND no data is being piped in - exit.
+    # if not args.filenames:
+    #     # Check if stdin (fd 0) is ready to be read
+    #     readable, _, _ = select.select([sys.stdin], [], [], 0.1)
+    #     if not readable:
+    #         print("Error: No input files or piped text stream.")
+    #         options_and_arguments().print_help()
+    #         sys.exit(1)
+
+    # Ingest files line by line. Join is here for long files.
+    # lines = []
+    # for line in fileinput.input(files=args.filenames or ['-'], encoding="utf-8"):
+    #     lines.append(line)
+    # raw_input = "".join(lines)
+
+    config = Config()
+
+    if args.provider_api_key:
+        if args.provider_api_key.startswith('sk-'):
+            if args.provider_api_key.startswith('sk-proj-'):
+                config.provider = 'OpenAI'
+                os.environ['OPENAI_API_KEY'] = args.provider_api_key
+            elif args.provider_api_key.startswith('sk-ant-'):
+                config.provider = 'Anthropic'
+                os.environ['ANTHROPIC_API_KEY'] = args.provider_api_key
+            elif args.provider_api_key.startswith('LLM_'):
+                config.provider = 'MetAI'
+                os.environ['METAI_API_KEY'] = args.provider_api_key
+            elif args.provider_api_key.startswith('tml-'):
+                config.provider = 'Tinker'
+                os.environ['TINKER_API_KEY'] = args.provider_api_key
+            else:
+                if config.provider == '':
+                    raise ValueError(f"Unrecognized API key prefix and no provider specified.")
+                else:
+                    if config.provider == 'Baseten':
+                        os.environ['BASETEN_API_KEY'] = args.provider_api_key
+                    elif config.provider == 'Fireworks':
+                        os.environ['FIREWORKS_API_KEY'] = args.provider_api_key
+                    elif config.provider == 'Lightning':
+                        os.environ['LIGHTNING_API_KEY'] = args.provider_api_key
+                    elif config.provider == 'DepSek':
+                        os.environ['DEPSEK_API_KEY'] = args.provider_api_key
+                    else:
+                        raise ValueError(f"Unsupported provider specified.")
+
+
+        config.provider_api_key = args.provider_api_key
+
+        if args.github_token:
+            config.github_token = args.github_token
+            os.environ['GITHUB_TOKEN'] = args.github_token
+
+    # Ingest files line by line. Join is here for long files.
+    lines = []
+    for line in fileinput.input(files=args.filenames or ['-'], encoding="utf-8"):
+        lines.append(line)
+    raw_input = "".join(lines)
+
+    from .main import machina
+
+    try:
+        thoughts, text = machina(raw_input, config)
+        output = new_plato_text(thoughts, text, config.name)
+        if args.append:
+            output = raw_input + '\n\n' + output
+        sys.stdout.write(output)
+        sys.stdout.flush()
+
+        # Assesment and signals.
+
+        utterance = "Machina is ready"
+        # Open syslog connection
+        syslog.openlog(
+            ident="machina-ratiocinatrix",
+            logoption=syslog.LOG_NDELAY,
+            facility=syslog.LOG_USER
+        )
+        # Signal (single line less than 4096 only!)
+        syslog.syslog(syslog.LOG_INFO, utterance)
+        syslog.closelog()
+
+    except Exception as e:
+        if args.debug:
+            import traceback
+            traceback.print_exc()
+        else:
+            sys.stderr.write(f'Machina did not work {e}\n')
+            sys.stderr.flush()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    run()

modi_cogitandi-0.0.1/src/modi_cogitandi/config.py

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+# Python
+
+"""Copyright (c) Alexander Fedotov.
+This source code is licensed under the license found in the
+LICENSE file in the root directory of this source tree.
+"""
+from os import environ
+from dataclasses import dataclass, field, fields, asdict
+
+
+@dataclass
+class Config:
+    github_token: str = field(default_factory=lambda: environ.get('GITHUB_TOKEN', ''))
+    github_name: str = field(default_factory=lambda: environ.get('GITHUB_NAME', ''))
+    github_email: str = field(default_factory=lambda: environ.get('GITHUB_EMAIL', ''))
+    provider_api_key: str = field(default_factory=lambda: environ.get('PROVIDER_API_KEY', ''))
+    provider: str = field(default_factory=lambda: environ.get('PROVIDER', ''))
+    machine_organization_name: str = field(
+        default_factory=lambda: environ.get('ORGANIZATION_NAME', 'machina-ratiocinatrix'))
+    private_repo_with_text: str = field(
+        default_factory=lambda: environ.get('REPO_WITH_INSTRUCTIONS', 'machina_ratiocinatrix'))
+    system_prompt_file: str = field(default_factory=lambda: environ.get('SYSTEM_INSTRUCTIONS_FILE', 'machina.yaml'))
+    name: str = field(default_factory=lambda: environ.get('NAME', ''))
+    instructions: str = field(default_factory=lambda: environ.get('INSTRUCTIONS', ''))
+    verb: str = field(default_factory=lambda: environ.get('VERB', ''))
+    tools: str = field(
+        default_factory=lambda: environ.get('TOOLS', ''))  # Swapped [] to '' for consistency with str annotation
+    rubric: str = field(default_factory=lambda: environ.get('RUBRIC', ''))
+
+    def to_dict(self):
+        return asdict(self)
+
+    def update_from_dict(self, data: dict):
+        # Now self.__dict__ is fully populated, but fields() is still safer!
+        valid_fields = {f.name for f in fields(self)}
+        for key, value in data.items():
+            if key in valid_fields:
+                setattr(self, key, value)
+
+
+if __name__ == '__main__':
+    ...