summarizing-machine 0.0.1__tar.gz

summarizing_machine-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.

summarizing_machine-0.0.1/MANIFEST.in

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

summarizing_machine-0.0.1/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: summarizing-machine
+Version: 0.0.1
+Summary: A Machine that summarizes texts.
+Author-email: Machina Ratiocinatrix <machina.ratio@gmail.com>, Alexander Fedotov <alex.fedotov@aol.com>
+Project-URL: Homepage, https://github.com/summarizing-machine/summarizing-machine
+Keywords: summarizing-machine
+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
+Requires-Dist: click==8.3.1
+Dynamic: license-file
+
+# Summarizing-Machine
+A Machine that summarizes texts.
+
+In order to launch it from the command line or as a Python subprocess:
+```bash
+echo "Theodotos-Alexandreus: Are language models seeking the Truth, machine?" \
+  | uvx summarizing-machine \
+    --provider-api-key=sk-proj-... \
+    --github-token=ghp_... 
+```
+
+Or, with a local pip installation:
+```bash
+pip install summarizing-machine
+```
+Set the environment variables:
+```bash
+export PROVIDER_API_KEY="sk-proj-..."
+export GITHUB_TOKEN="ghp_..."
+```
+Then:
+```bash
+summarizing-machine multilogue.txt
+```
+Or:
+```bash
+summarizing-machine multilogue.txt new_turn.txt
+```
+Or:
+```bash
+cat multilogue.txt | summarizing-machine
+```
+Or:
+```bash
+cat multilogue.txt | summarizing-machine > multilogue.txt
+```
+Or: 
+```bash
+(cat multilogue.txt; echo:"Theodotos: What do you think, Summarizing-Machine?") \
+  | summarizing-machine
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | summarizing-machine
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | summarizing-machine > multilogue.txt
+```
+Or, if you have installed other machines:
+```bash
+cat multilogue.md | summarizing-machine \
+  | summarizing-machine | judging-machine > summary_judgment.md
+```
+
+Or use it in your Python code:
+```Python
+# Python
+import thinking_machine
+```

summarizing_machine-0.0.1/README.md

@@ -0,0 +1,60 @@
+# Summarizing-Machine
+A Machine that summarizes texts.
+
+In order to launch it from the command line or as a Python subprocess:
+```bash
+echo "Theodotos-Alexandreus: Are language models seeking the Truth, machine?" \
+  | uvx summarizing-machine \
+    --provider-api-key=sk-proj-... \
+    --github-token=ghp_... 
+```
+
+Or, with a local pip installation:
+```bash
+pip install summarizing-machine
+```
+Set the environment variables:
+```bash
+export PROVIDER_API_KEY="sk-proj-..."
+export GITHUB_TOKEN="ghp_..."
+```
+Then:
+```bash
+summarizing-machine multilogue.txt
+```
+Or:
+```bash
+summarizing-machine multilogue.txt new_turn.txt
+```
+Or:
+```bash
+cat multilogue.txt | summarizing-machine
+```
+Or:
+```bash
+cat multilogue.txt | summarizing-machine > multilogue.txt
+```
+Or: 
+```bash
+(cat multilogue.txt; echo:"Theodotos: What do you think, Summarizing-Machine?") \
+  | summarizing-machine
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | summarizing-machine
+```
+Or:
+```bash
+cat multilogue.txt new_turn.txt | summarizing-machine > multilogue.txt
+```
+Or, if you have installed other machines:
+```bash
+cat multilogue.md | summarizing-machine \
+  | summarizing-machine | judging-machine > summary_judgment.md
+```
+
+Or use it in your Python code:
+```Python
+# Python
+import thinking_machine
+```

summarizing_machine-0.0.1/pyproject.toml

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

summarizing_machine-0.0.1/setup.cfg

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

summarizing_machine-0.0.1/src/summarizing_machine/__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 .machine import machine
+from .githf import fetch_instructions
+from .utilities import (plato_text_to_muj,
+                        plato_text_to_mpuj,
+                        llm_soup_to_text,
+                        new_plato_text)
+
+__all__ = [
+    'machine',
+    'fetch_instructions',
+    'Config'
+]

summarizing_machine-0.0.1/src/summarizing_machine/cli.py

@@ -0,0 +1,96 @@
+# -*- 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
+import sys
+import click
+import fileinput
+from .config import Config
+from .utilities import new_plato_text
+
+
+@click.command()
+@click.option('-k', '--provider-api-key',
+              envvar='PROVIDER_API_KEY',
+              default='no_key', help='Language Model API provider key.')
+@click.option('-t', '--github-token', envvar='GITHUB_TOKEN',
+              default='no_token', help='GitHub API token for private repo access.')
+@click.option('-d', '--debug/--no-debug',
+              default=False, help='Print full stack trace on errors.')
+@click.option('-i', '--interactive',
+              is_flag=True, help='Respond and stay interactive')
+@click.argument('filenames', nargs=-1,
+                type=click.Path(exists=True))
+def run(provider_api_key, github_token, debug, interactive, filenames):
+    """
+    $ text | summarizing-machine                        # Accepts text from the pipe
+    $ echo "...<text>..." | summarizing-machine         #
+
+    $ summarizing-machine multilogue.txt new_turn.txt    # ...or files.
+    """
+    config = Config()
+    
+    if provider_api_key:
+        if provider_api_key.startswith('sk-'):
+            if provider_api_key.startswith('sk-proj-'):
+                config.provider = 'OpenAI'
+                environ['OPENAI_API_KEY'] = provider_api_key
+            elif provider_api_key.startswith('sk-ant-'):
+                config.provider = 'Anthropic'
+                environ['ANTHROPIC_API_KEY'] = provider_api_key
+            else:
+                config.provider = 'DepSek'
+                environ['DEPSEK_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('AIzaSy'):
+            config.provider = 'Gemini'
+            environ['GEMINI_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('gsk_'):
+            config.provider = 'Groq'
+            environ['GROQ_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('xai-'):
+            config.provider = 'XAI'
+            environ['XAI_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('LLM|'):
+            config.provider = 'Meta'
+            environ['META_API_KEY'] = provider_api_key
+        elif provider_api_key == 'no_provider_key':
+            sys.stderr.write(f'No provider key!\n')
+            sys.stderr.flush()
+            sys.exit(1)
+        else:
+            if config.provider == '':
+                raise ValueError(f"Unrecognized API key prefix and no provider specified.")
+                
+        config.provider_api_key = provider_api_key
+        
+    if github_token:
+        config.github_token = github_token
+        environ['GITHUB_TOKEN'] = github_token
+
+    raw_input = ''
+    for line in fileinput.input(files=filenames or ('-',), encoding="utf-8"):
+        raw_input += line
+
+    from .machine import machine
+
+    try:
+        thoughts, text = machine(raw_input, config)
+        output = raw_input + '\n\n' + new_plato_text(thoughts, text, config.name)
+        sys.stdout.write(output)
+        sys.stdout.flush()
+    except Exception as e:
+        if debug:
+            import traceback
+            traceback.print_exc()
+        else:
+            sys.stderr.write(f'Machine did not work {e}\n')
+            sys.stderr.flush()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    run()

summarizing_machine-0.0.1/src/summarizing_machine/config.py

@@ -0,0 +1,23 @@
+# -*- 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
+
+
+@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('MACHINE_ORGANIZATION_NAME', 'summarizing-machine'))
+    private_repo_with_text: str     = field(default_factory=lambda: environ.get('PRIVATE_REPO_WITH_TEXT','summarizing_machine'))
+    system_prompt_file: str         = field(default_factory=lambda: environ.get('SYSTEM_PROMPT_FILE', 'machina.yaml'))
+    name: str                       = ''
+    instructions: str               = ''

summarizing_machine-0.0.1/src/summarizing_machine/githf.py

@@ -0,0 +1,69 @@
+# -*- 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 sys
+from os import path
+import yaml
+import urllib.request
+import urllib.error
+
+
+def download_github_file(owner, repo, file_path, token):
+    """
+    Downloads a file from a GitHub repository using the GitHub REST API.
+    We request the raw content by using the 'application/vnd.github.v3.raw' accept header.
+    """
+    url = f"https://api.github.com/repos/{owner}/{repo}/contents/{file_path}"
+
+    headers = {
+        "Authorization": f"token {token}",
+        "Accept": "application/vnd.github.v3.raw",
+        "User-Agent": "Summarizing-Machine"
+    }
+
+    req = urllib.request.Request(url, headers=headers)
+
+    try:
+        with urllib.request.urlopen(req, timeout=10) as response:
+            return response.read()
+    except urllib.error.HTTPError as e:
+        print(f"HTTP Error {e.code}: {e.reason}")
+        error_info = e.read().decode('utf-8')
+        print(f"Details: {error_info}")
+        return None
+    except urllib.error.URLError as e:
+        print(f"URL Error: {e.reason}")
+        return None
+
+
+def fetch_instructions(config):
+    """Retrieve the system prompt from a private GitHub repo.
+    Falls back to the local machina.yaml if GitHub is unreachable.
+    Returns the 'name' of the Machine in dashed format.
+    Returns the 'description' field from the YAML as the system prompt string.
+    """
+    try:
+        raw_yaml = download_github_file(
+            owner=config.machine_organization_name,
+            repo=config.private_repo_with_text,
+            file_path=config.system_prompt_file,
+            token=config.github_token
+        )
+    except Exception as e:
+        print(f"Warning: could not fetch the instructions from GitHub: {e}",
+              file=sys.stderr)
+        local_path = path.join(path.dirname(__file__), 'machina.yaml')
+        with open(local_path, 'r') as f:
+            raw_yaml = f.read()
+
+    # Parse
+    parsed = yaml.safe_load(raw_yaml)
+    name = parsed.get('name')
+    config.name = name
+    instructions = parsed.get('description', 'You are a helpful assistant.')
+    config.instructions = instructions
+    return name, instructions

summarizing_machine-0.0.1/src/summarizing_machine/machina.yaml

@@ -0,0 +1,7 @@
+# Copyright (c) Alexander Fedotov, 2026. All rights reserved.
+name: Summarizing-Machine
+description: The Assistant is Summarizing-Machine. Summarizing-Machine does its best to understand
+  the conversation that it is participating in and answers in a most thoughtful way possible
+  the questions that it is being asked. 
+  Summarizing-Machine responds in plain text without any markdown, emphasis or lists. All 
+  paragraphs except the first should begin with a newline and tab.

summarizing_machine-0.0.1/src/summarizing_machine/machine.py

@@ -0,0 +1,177 @@
+# -*- 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 sys
+from os import environ, path
+from .githf import fetch_instructions
+from .utilities import (plato_text_to_muj,
+                        plato_text_to_mpuj,
+                        plato_text_to_cmj,
+                        llm_soup_to_text)
+
+
+def machine(plato_text, config, **kwargs):
+    """Core agent logic.
+
+    1. Fetches the system prompt from a private GitHub repo.
+    2. Calls Provider
+    3. Returns a (thoughts, text) tuple.
+    """
+    # Fetch the confidential system prompt, name is for a checkup.
+    name, system_prompt = fetch_instructions(config)
+
+    # Load an appropriate library and query the API.
+    provider = config.provider
+    api_key  = config.provider_api_key
+    
+    if provider == 'OpenAI':
+        # Transform plato_text to MUJ format
+        messages = plato_text_to_muj(plato_text=plato_text,
+                                     machine_name=name)
+        # Call OpenAI API via opehaina
+        environ['OPENAI_API_KEY'] = api_key
+        try:
+            from .providers import openai
+        except ImportError:
+            print("openai module is missing.", file=sys.stderr)
+            sys.exit(1)
+            
+        thoughts, text = openai.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+
+        thoughts = llm_soup_to_text(thoughts)
+        return thoughts, text
+
+    elif provider == 'Gemini':
+        # Transform plato_text to MPUJ format
+        messages = plato_text_to_mpuj(plato_text=plato_text,
+                                     machine_name=name)
+        # Call Gemini through castor-polux
+        environ['GEMINI_API_KEY'] = api_key
+        try:
+            from .providers import castor_pollux
+        except ImportError:
+            print("No module castor-pollux", file=sys.stderr)
+            sys.exit(1)
+            
+        thoughts, text = castor_pollux.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+
+        thoughts = llm_soup_to_text(thoughts)
+        return thoughts, text
+
+    elif provider == 'Anthropic':
+        # Transform plato_text to MUJ format
+        messages = plato_text_to_muj(plato_text=plato_text,
+                                     machine_name=name)
+
+        # Call the Anthropic API via electroid
+        environ['ANTHROPIC_API_KEY'] = api_key
+        try:
+            from .providers import electroid
+        except ImportError:
+            print("no electroid module", file=sys.stderr)
+            sys.exit(1)
+            
+        text, thoughts = electroid.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+        return text, thoughts
+
+    elif provider == 'Groq':
+        # Transform plato_text to MUJ format
+        messages = plato_text_to_muj(plato_text=plato_text,
+                                     machine_name=name)
+        # Call OpenAI API via opehaina
+        environ['GROQ_API_KEY'] = api_key
+        try:
+            from .providers import qrog
+        except ImportError:
+            print("openai module is missing.", file=sys.stderr)
+            sys.exit(1)
+
+        thoughts, text = qrog.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+
+        thoughts = llm_soup_to_text(thoughts)
+        return thoughts, text
+
+    elif provider == 'Xai':
+        # Transform plato_text to MUJ format
+        messages = plato_text_to_muj(plato_text=plato_text,
+                                     machine_name=name)
+        # Call OpenAI API via opehaina
+        environ['XAI_API_KEY'] = api_key
+        try:
+            from .providers import strangelove
+        except ImportError:
+            print("openai module is missing.", file=sys.stderr)
+            sys.exit(1)
+
+        thoughts, text = strangelove.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+
+        thoughts = llm_soup_to_text(thoughts)
+        return thoughts, text
+
+    elif provider == 'DepSek':
+        # Transform plato_text to CMJ format
+        messages = plato_text_to_cmj(plato_text=plato_text,
+                                     machine_name=name)
+        # Call OpenAI API via opehaina
+        environ['DEPSEK_API_KEY'] = api_key
+        try:
+            from .providers import depsek
+        except ImportError:
+            print("openai module is missing.", file=sys.stderr)
+            sys.exit(1)
+
+        thoughts, text = depsek.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+
+        return thoughts, text
+
+    elif provider == 'Meta':
+        # Transform plato_text to CMJ format
+        messages = plato_text_to_cmj(plato_text=plato_text,
+                                     machine_name=name)
+        # Call OpenAI API via opehaina
+        environ['META_API_KEY'] = api_key
+        try:
+            from .providers import camelids
+        except ImportError:
+            print("openai module is missing.", file=sys.stderr)
+            sys.exit(1)
+
+        thoughts, text = camelids.respond(
+            messages=messages,
+            instructions=system_prompt,
+            **kwargs
+        )
+
+        return thoughts, text
+
+
+if __name__ == '__main__':
+    print('You have launched main')

summarizing_machine-0.0.1/src/summarizing_machine/providers/__init__.py

@@ -0,0 +1,7 @@
+# -*- 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.
+"""