writing-machine 0.0.1__tar.gz

writing_machine-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 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.

writing_machine-0.0.1/MANIFEST.in

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

writing_machine-0.0.1/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: writing-machine
+Version: 0.0.1
+Summary: A Machine that writes texts.
+Author-email: Machina Ratiocinatrix <machina.ratio@gmail.com>
+Project-URL: Homepage, https://github.com/writing-machine/writing-machine
+Project-URL: Bug Tracker, https://github.com/writing-machine/writing-machine/issues
+Keywords: writing-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: electroid>=0.0.16
+Requires-Dist: opehaina>=0.0.1
+Requires-Dist: PyGithub>=2.6.0
+Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: urllib3>=2.0.4
+Requires-Dist: requests>=2.32.3
+Requires-Dist: click>=8.3.0
+Dynamic: license-file
+
+# Writing Machine
+A Machine that writes texts.
+```bash
+  echo '[{"role": "user", "content": "Write an explanatory text..."}]' \
+    | uvx writing-machine \
+        --provider-api-key=sk-ant-api... \
+        --github-token=ghp_... \
+        --mode=single
+```
+Or:
+```bash
+  pip install writing-machine
+```
+Then:
+```Python
+  # Python
+  import writing_machine
+```

writing_machine-0.0.1/README.md

@@ -0,0 +1,18 @@
+# Writing Machine
+A Machine that writes texts.
+```bash
+  echo '[{"role": "user", "content": "Write an explanatory text..."}]' \
+    | uvx writing-machine \
+        --provider-api-key=sk-ant-api... \
+        --github-token=ghp_... \
+        --mode=single
+```
+Or:
+```bash
+  pip install writing-machine
+```
+Then:
+```Python
+  # Python
+  import writing_machine
+```

writing_machine-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=67.0"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "writing-machine"
+version = "0.0.1"
+authors = [
+    {name="Machina Ratiocinatrix", email="machina.ratio@gmail.com"},
+]
+description = "A Machine that writes texts."
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+]
+
+keywords = ["writing-machine"]
+
+dependencies = [
+    "electroid >= 0.0.16",
+    "opehaina >= 0.0.1",
+    "PyGithub >= 2.6.0",
+    "PyYAML >= 6.0.1",
+    "urllib3 >= 2.0.4",
+    "requests >= 2.32.3",
+    "click >= 8.3.0"
+]
+
+[project.scripts]
+writing-machine = "writing_machine.cli:run"
+
+[project.urls]
+"Homepage" = "https://github.com/writing-machine/writing-machine"
+"Bug Tracker" = "https://github.com/writing-machine/writing-machine/issues"

writing_machine-0.0.1/setup.cfg

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

writing_machine-0.0.1/src/writing_machine/__init__.py

@@ -0,0 +1,19 @@
+# -*- 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 settings
+from .machine import machine
+from .githf import connect_to_repo, read_file
+
+config = dict()
+
+__all__ = [
+    'machine',
+    'connect_to_repo',
+    'read_file',
+    'settings'
+]

writing_machine-0.0.1/src/writing_machine/cli.py

@@ -0,0 +1,119 @@
+# -*- 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 .config import settings
+import sys
+import json
+import click
+
+
+@click.command()
+@click.option('--provider-api-key', 'provider_api_key', envvar='PROVIDER_API_KEY',
+              default='', help='Language Model API provider key.')
+@click.option('--github-token', 'github_token', envvar='GITHUB_TOKEN',
+              default='', help='GitHub API token for private repo access.')
+@click.option('--mode', type=click.Choice(['single', 'daemon']),
+              default='single',
+              help='single: one-shot stdin→stdout. '
+                   'interactive: line-delimited JSON loop.')
+def run(provider_api_key, github_token, mode):
+    """writing-machine: an AI agent communicating via stdin/stdout.
+
+    In 'single' mode (default): reads a full JSON array from stdin,
+    responds once, and exits.
+
+    In 'daemon' mode: reads one JSON line at a time from stdin,
+    responds with one JSON line on stdout, and loops until EOF or SIGINT.
+    """
+    # Set environment variables so electroid and githf pick them up
+    if provider_api_key:
+        if provider_api_key.startswith('sk-proj-'):
+            settings['provider'] = 'OpenAI'
+            environ['OPENAI_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('sk-ant-'):
+            settings['provider'] = 'Anthropic'
+            environ['ANTHROPIC_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('AIzaSy'):
+            settings['provider'] = 'Gemini'
+            environ['GEMINI_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('gsk_'):
+            settings['provider'] = 'Groq'
+            environ['GROQ_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('xai-'):
+            settings['provider'] = 'XAI'
+            environ['XAI_API_KEY'] = provider_api_key
+        elif provider_api_key.startswith('LLM|'):
+            settings['provider'] = 'Meta'
+            environ['META_API_KEY'] = provider_api_key
+        else:
+            if settings['provider'] == '':
+                raise ValueError(f"Unrecognized API key prefix and no provider specified.")
+    if github_token:
+        environ['GITHUB_TOKEN'] = github_token
+
+    from .machine import machine
+
+    if mode == 'daemon':
+        _run_daemon(machine)
+    else:
+        _run_single(machine)
+
+
+def _run_single(machine):
+    """One-shot mode: read full JSON from stdin, respond, exit."""
+    try:
+        messages = json.load(sys.stdin)
+    except json.JSONDecodeError as e:
+        print(f"Error: invalid JSON on stdin: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if not isinstance(messages, list):
+        print("Error: stdin must contain a JSON array of messages.",
+              file=sys.stderr)
+        sys.exit(1)
+
+    text, thoughts = machine(messages)
+    json.dump([text, thoughts], sys.stdout)
+
+
+def _run_daemon(machine):
+    """Daemon: line-delimited JSON loop.
+
+    Each line on stdin is a JSON array of messages.
+    Each response is a JSON array [text, thoughts] followed by newline.
+    Loops until SIGINT on stdin.
+    """
+    print("daemon", file=sys.stderr)
+    try:
+        # Loop blocks until input is available on stdin
+        for line in sys.stdin:
+            line = line.strip()
+            if not line:
+                continue
+
+            try:
+                messages = json.loads(line)
+            except json.JSONDecodeError as e:
+                print(f"Error: invalid JSON: {e}", file=sys.stderr)
+                continue
+
+            if not isinstance(messages, list):
+                print("Error: expected a JSON array of messages.",
+                      file=sys.stderr)
+                continue
+
+            text, thoughts = machine(messages)
+            json.dump([text, thoughts], sys.stdout)
+            sys.stdout.write('\n')
+            sys.stdout.flush()
+    except KeyboardInterrupt:
+        sys.exit(0)
+
+
+if __name__ == '__main__':
+    run()

writing_machine-0.0.1/src/writing_machine/config.py

@@ -0,0 +1,22 @@
+# -*- 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
+
+
+settings = dict(
+    github_token                = environ.get('GITHUB_TOKEN', ''),
+    github_name                 = environ.get('GITHUB_NAME', ''),
+    github_email                = environ.get('GITHUB_EMAIL', ''),
+    provider_api_key            = environ.get('PROVIDER_API_KEY', ''),
+    provider                    = environ.get('PROVIDER', ''),
+    machine_organization_name   = environ.get('MACHINE_ORGANIZATION_NAME', 'writing-machine'),
+    private_repo_with_text      = environ.get('PRIVATE_REPO_WITH_TEXT','writing_machine'),
+    system_prompt_file          = environ.get('SYSTEM_PROMPT_FILE', 'machina.yaml'),
+    name                        = '',
+    instructions                = ''
+)

writing_machine-0.0.1/src/writing_machine/githf.py

@@ -0,0 +1,97 @@
+# -*- 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 github import Github, UnknownObjectException
+from urllib3 import disable_warnings
+
+
+github_token    = environ.get('GITHUB_TOKEN', '')
+github_name     = environ.get('GITHUB_NAME', '')
+github_email    = environ.get('GITHUB_EMAIL', '')
+
+# The useless urllib3 warning is too maddening for an ordinary human being.
+disable_warnings()
+
+
+# Repo
+def connect_to_repo(organization=None,
+                   repository_name=None,
+                   private=False):
+    """
+    Establish a connection with a GitHub repository.
+
+    Args:
+        organization (str, optional): The name of the organization. If not provided,
+            the repository is assumed to be owned by the authenticated user.
+        repository_name (str): The name of the repository.
+        private (bool, optional): Whether the repository is private. Defaults to False.
+
+    Returns:
+        github.Repository.Repository: The GitHub repository object if the connection is successful.
+        None: If the connection fails.
+
+    Raises:
+        github.UnknownObjectException: If the repository does not exist.
+
+    Note:
+        The function requires the following environment variables to be set:
+        - GITHUB_TOKEN: The personal access token for authentication.
+        - GITHUB_NAME: The name of the authenticated user.
+        - GITHUB_EMAIL: The email of the authenticated user.
+
+    """
+
+    gh = Github(github_token, verify=False)
+    if organization:
+        org = gh.get_organization(organization)
+        try:
+            repo = org.get_repo(f'{repository_name}')
+        except UnknownObjectException:
+            # print('Can not connect YOU to this repo in this organization')
+            repo = None
+        return repo
+    else:
+        user = gh.get_user()
+        try:
+            repo = user.get_repo(repository_name)
+        except UnknownObjectException:
+            # print('Can not connect YOU to this repo')
+            repo = None
+        return repo
+
+
+def read_file(repository,
+              file_path):
+    """
+    Read the contents of a file in a GitHub repository.
+
+    Args:
+        repository (github.Repository.Repository): The GitHub repository object.
+        file_path (str): The path to the file in the repository, formatted as
+            'directory_in_repo/subdirectory/file.ext'.
+
+    Returns:
+        str: The contents of the file as a string. If the file does not exist, an empty string is returned.
+
+    Raises:
+        github.UnknownObjectException: If the file does not exist in the repository.
+
+    Note:
+        This function assumes that the repository object has already been authenticated and connected.
+    """
+    try:
+        # Get the file if it exists
+        ingested_file = repository.get_contents(file_path)
+        content = ingested_file.decoded_content.decode("utf-8")
+
+    except UnknownObjectException:
+        # The file doesn't exist
+        # print('The file does not exist')
+        content = ''
+
+    return content

writing_machine-0.0.1/src/writing_machine/machina.yaml

@@ -0,0 +1,3 @@
+# Copyright (c) Alexander Fedotov, 2026. All rights reserved.
+name: writing-machine
+description: You are writing-machine.

writing_machine-0.0.1/src/writing_machine/machine.py

@@ -0,0 +1,87 @@
+# -*- 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, path
+from .config import settings
+import sys
+import yaml
+from . import githf  # from .
+
+
+def _fetch_instructions():
+    """Retrieve the system prompt from a private GitHub repo.
+    Falls back to the local machina.yaml if GitHub is unreachable.
+    Returns the 'description' field from the YAML as the system prompt string.
+    """
+    try:
+        repo = githf.connect_to_repo(
+            organization=settings['machine_organization_name'],
+            repository_name=settings['private_repo_with_text'],
+            private=True
+        )
+        raw_yaml = githf.read_file(
+            repository=repo,
+            file_path=settings['system_prompt_file']
+        )
+    except Exception as e:
+        print(f"Warning: could not fetch prompt 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 whatever you've gotten.
+    parsed = yaml.safe_load(raw_yaml)
+    name = parsed.get('name')
+    settings['name'] = name
+    instructions = parsed.get('description', 'You are a helpful assistant.')
+    settings['instructions'] = instructions
+    return name, instructions
+
+
+def machine(messages):
+    """Core agent logic.
+
+    1. Fetches the system prompt from a private GitHub repo.
+    2. Calls Anthropic via electroid.cloud() with the messages.
+    3. Returns (text, thoughts) tuple.
+    """
+    # Fetch the confidential system prompt
+    name, system_prompt = _fetch_instructions()
+
+    # Load an appropriate library and query the API.
+    provider = settings['provider']
+    if provider == 'OpenAI':
+        # Call OpenAI API via opehaina
+        import opehaina
+        text, thoughts = opehaina.stream(
+            messages=messages,
+            system=system_prompt,
+            max_tokens=100000
+        )
+        return text, thoughts
+
+    elif provider == 'Anthropic':
+        # Call the Anthropic API via electroid
+        import electroid
+        text, thoughts = electroid.stream(
+            messages=messages,
+            system=system_prompt,
+            max_tokens=100000
+        )
+        return text, thoughts
+
+    elif provider == 'Groq':
+        ...
+    elif provider == 'Xai':
+        ...
+    elif provider == 'Meta':
+        ...
+
+
+if __name__ == '__main__':
+    machine([])

writing_machine-0.0.1/src/writing_machine.egg-info/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: writing-machine
+Version: 0.0.1
+Summary: A Machine that writes texts.
+Author-email: Machina Ratiocinatrix <machina.ratio@gmail.com>
+Project-URL: Homepage, https://github.com/writing-machine/writing-machine
+Project-URL: Bug Tracker, https://github.com/writing-machine/writing-machine/issues
+Keywords: writing-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: electroid>=0.0.16
+Requires-Dist: opehaina>=0.0.1
+Requires-Dist: PyGithub>=2.6.0
+Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: urllib3>=2.0.4
+Requires-Dist: requests>=2.32.3
+Requires-Dist: click>=8.3.0
+Dynamic: license-file
+
+# Writing Machine
+A Machine that writes texts.
+```bash
+  echo '[{"role": "user", "content": "Write an explanatory text..."}]' \
+    | uvx writing-machine \
+        --provider-api-key=sk-ant-api... \
+        --github-token=ghp_... \
+        --mode=single
+```
+Or:
+```bash
+  pip install writing-machine
+```
+Then:
+```Python
+  # Python
+  import writing_machine
+```

writing_machine-0.0.1/src/writing_machine.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+src/writing_machine/__init__.py
+src/writing_machine/cli.py
+src/writing_machine/config.py
+src/writing_machine/githf.py
+src/writing_machine/machina.yaml
+src/writing_machine/machine.py
+src/writing_machine.egg-info/PKG-INFO
+src/writing_machine.egg-info/SOURCES.txt
+src/writing_machine.egg-info/dependency_links.txt
+src/writing_machine.egg-info/entry_points.txt
+src/writing_machine.egg-info/requires.txt
+src/writing_machine.egg-info/top_level.txt

writing_machine-0.0.1/src/writing_machine.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

writing_machine-0.0.1/src/writing_machine.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+writing-machine = writing_machine.cli:run

writing_machine-0.0.1/src/writing_machine.egg-info/requires.txt

@@ -0,0 +1,7 @@
+electroid>=0.0.16
+opehaina>=0.0.1
+PyGithub>=2.6.0
+PyYAML>=6.0.1
+urllib3>=2.0.4
+requests>=2.32.3
+click>=8.3.0

writing_machine-0.0.1/src/writing_machine.egg-info/top_level.txt

@@ -0,0 +1 @@
+writing_machine