owlmind 0.1.2__tar.gz → 0.1.5__tar.gz

owlmind-0.1.5/LICENSE.txt

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

{owlmind-0.1.2/src/owlmind.egg-info → owlmind-0.1.5}/PKG-INFO

@@ -1,10 +1,15 @@
 Metadata-Version: 2.4
 Name: owlmind
-Version: 0.1.2
-Summary: A modular CLI for local Ollama control
-Requires-Python: >=3.8
+Version: 0.1.5
+Summary: Experimentation environment and pedagogical sandbox for studying generative intelligence systems.
+Author-email: Fernando Koch <your-email@example.com>
+License: MIT
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: ollama
+License-File: LICENSE.txt
+Requires-Dist: ollama>=0.4.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
 
 
 <!---
@@ -24,17 +29,20 @@ Requires-Dist: ollama
 
 ## Overview
 
-The OwlMind Platform is a foundational experimentation environment engineered by The Generative Intelligence Lab. It serves as a pedagogical sandbox where students and researchers can interrogate the mechanics of Generative Intelligence. By implementing a standardized CLI over a provider-agnostic abstraction layer, OwlMind enables learners to conduct comparative analyses of LLM behaviors through interchangeable parameters within a controlled, observable setup
+The OwlMind Framework provides an experimentation environment and pedagogical sandbox for [Generative Intelligence Systems](https://medium.com/lecture-notes-on-generative-intelligence/generative-intelligence-systems-5b23727acffe). The platform defines a standardized programming structure and command-line interface across multiple architectural layers. This structure enables comparative experiments around the behaviors of Large Language Models (LLMs), AI pipelines, and component-level configurations.
 
-Installation:
+#### Installation:
 
 ```bash
 pip install owlmind
 ```
 
----
+If the installation goes well, you should be able to run the script:
+
+```bash
+owlmind --version
+```
 
-## Commands
 
 #### Configuration 
 Control OwlMind via environment variables
@@ -47,15 +55,18 @@ export OLLAMA_HOST=http://localhost:11434
 export OLLAMA_MODEL=llama3
 ```
 
-
-#### System Audit
-View your current environment configuration
+A good alternative is to create a ``.env`` file.
 
 ```bash
-owlmind info
+# File: .env
+# .env files are loaded automatically 
+
+OLLAMA_HOST=http://localhost:11434
+OLLAMA_MODEL=llama
 ```
 
-#### Connectivity Check 
+
+#### Connectivity 
 Verify if your model provider is online.
 
 ```bash
@@ -63,14 +74,21 @@ owlmind ping
 ```
 
 
-#### Generation
+#### Information
+View your environment information.
+
+```bash
+owlmind info
+```
+
+#### Generation with Parameters
 Run inference with full control over sampling parameters.
 
 ```bash
 owlmind query "How do AI-driven organizations scale?" --temp 1.2 --ctx-size 4096
 ```
 
-Possible parameters:
+Other parameters:
 
 ```bash
 $ owlmind query --help
@@ -94,7 +112,7 @@ options:
 ```
 
 
-#### Prompt Loading (@file syntax)
+#### Prompt Loading
 OwlMind supports loading prompts directly from files using the @ prefix. This is ideal for long-form instructions or code analysis.
 
 ```bash
@@ -107,3 +125,4 @@ Explicit Flag:
 owlmind query --input research_paper.md
 ```
 
+

owlmind-0.1.2/PKG-INFO → owlmind-0.1.5/README.md

@@ -1,11 +1,3 @@
-Metadata-Version: 2.4
-Name: owlmind
-Version: 0.1.2
-Summary: A modular CLI for local Ollama control
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Requires-Dist: ollama
-
 
 <!---
 <img src="https://generativeintelligencelab.ai/images/owlmind-banner.png" width=800>
@@ -24,17 +16,20 @@ Requires-Dist: ollama
 
 ## Overview
 
-The OwlMind Platform is a foundational experimentation environment engineered by The Generative Intelligence Lab. It serves as a pedagogical sandbox where students and researchers can interrogate the mechanics of Generative Intelligence. By implementing a standardized CLI over a provider-agnostic abstraction layer, OwlMind enables learners to conduct comparative analyses of LLM behaviors through interchangeable parameters within a controlled, observable setup
+The OwlMind Framework provides an experimentation environment and pedagogical sandbox for [Generative Intelligence Systems](https://medium.com/lecture-notes-on-generative-intelligence/generative-intelligence-systems-5b23727acffe). The platform defines a standardized programming structure and command-line interface across multiple architectural layers. This structure enables comparative experiments around the behaviors of Large Language Models (LLMs), AI pipelines, and component-level configurations.
 
-Installation:
+#### Installation:
 
 ```bash
 pip install owlmind
 ```
 
----
+If the installation goes well, you should be able to run the script:
+
+```bash
+owlmind --version
+```
 
-## Commands
 
 #### Configuration 
 Control OwlMind via environment variables
@@ -47,15 +42,18 @@ export OLLAMA_HOST=http://localhost:11434
 export OLLAMA_MODEL=llama3
 ```
 
-
-#### System Audit
-View your current environment configuration
+A good alternative is to create a ``.env`` file.
 
 ```bash
-owlmind info
+# File: .env
+# .env files are loaded automatically 
+
+OLLAMA_HOST=http://localhost:11434
+OLLAMA_MODEL=llama
 ```
 
-#### Connectivity Check 
+
+#### Connectivity 
 Verify if your model provider is online.
 
 ```bash
@@ -63,14 +61,21 @@ owlmind ping
 ```
 
 
-#### Generation
+#### Information
+View your environment information.
+
+```bash
+owlmind info
+```
+
+#### Generation with Parameters
 Run inference with full control over sampling parameters.
 
 ```bash
 owlmind query "How do AI-driven organizations scale?" --temp 1.2 --ctx-size 4096
 ```
 
-Possible parameters:
+Other parameters:
 
 ```bash
 $ owlmind query --help
@@ -94,7 +99,7 @@ options:
 ```
 
 
-#### Prompt Loading (@file syntax)
+#### Prompt Loading
 OwlMind supports loading prompts directly from files using the @ prefix. This is ideal for long-form instructions or code analysis.
 
 ```bash
@@ -107,3 +112,4 @@ Explicit Flag:
 owlmind query --input research_paper.md
 ```
 
+

owlmind-0.1.5/pyproject.toml

@@ -0,0 +1,35 @@
+# =================================================================
+# Project Configuration (for OwlMind)
+# =================================================================
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "owlmind"
+dynamic = ["version"]
+description = "Experimentation environment and pedagogical sandbox for studying generative intelligence systems."
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "Fernando Koch", email = "your-email@example.com"}
+]
+dependencies = [
+    "ollama>=0.4.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.scripts]
+owlmind = "owlmind.cli:main"
+
+[tool.setuptools.dynamic]
+# This points to src/owlmind/__init__.py -> __version__
+version = {attr = "owlmind.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"*" = ["*.txt", "*.json", "*.md"]

owlmind-0.1.5/src/owlmind/__init__.py

@@ -0,0 +1,5 @@
+"""
+OwlMind Framework - experimentation environment for Generative Intelligence Systems.
+"""
+
+__version__ = "0.1.5"

owlmind-0.1.5/src/owlmind/cli.py

@@ -0,0 +1,236 @@
+
+#!/usr/bin/env python3
+##
+## OwlMind Framework - experimentation environment for Generative Intelligence Systems.
+## cli.py — Command-line interface.
+##
+# Copyright (c) 2025, The Generative Intelligence Lab
+#    https://github.com/genilab/owlmind
+#
+# Disclosure:
+# This framework was developed using a 'vibe coding' . AI-synthesized logic was 
+# subjected to human review and manual refinement to guarantee functional 
+# integrity and structural clarity.
+#
+
+import argparse
+import os
+import sys
+import logging
+from owlmind import __version__
+from owlmind.models import Ollama
+
+class Dispatcher:
+    """Orchestrates components using the OwlMind Launch standards."""
+
+    DEFAULT_LOG_LEVEL = Ollama.LOG_CRITICAL
+
+    @staticmethod
+    def load_env(filepath=".env"):
+        """Manually parses a .env file and injects into os.environ."""
+        if not os.path.exists(filepath):
+            return
+        try:
+            with open(filepath, "r", encoding="utf-8") as f:
+                for line in f:
+                    line = line.strip()
+                    if not line or line.startswith("#") or "=" not in line:
+                        continue
+                    key, value = line.split("=", 1)
+                    key, value = key.strip(), value.strip().strip("'").strip('"')
+                    if key not in os.environ:
+                        os.environ[key] = value
+        except Exception as e:
+            print(f"Warning: Could not load .env file: {e}", file=sys.stderr)
+
+    @staticmethod
+    def parse_params(raw_params: list) -> dict:
+        """
+        Parses parameters into a typed dictionary.
+        Handles: -p k=v,k2=v2 AND -p k=v -p k2=v2
+        """
+        params = {}
+        if not raw_params:
+            return params
+            
+        # 1. Flatten the list and split by commas
+        # If raw_params is ['temp=1', 'seed=42,top_k=10'], this flattens it correctly
+        tokens = []
+        for item in raw_params:
+            tokens.extend(item.split(','))
+            
+        for kv in tokens:
+            if "=" not in kv:
+                continue
+            
+            k, v = kv.split("=", 1)
+            k, v = k.strip(), v.strip()
+            
+            # 2. Type Inference (Boolean, Int, Float, String)
+            if v.lower() == "true":
+                v = True
+            elif v.lower() == "false":
+                v = False
+            else:
+                try:
+                    # Try Integer
+                    v = int(v)
+                except ValueError:
+                    try:
+                        # Try Float
+                        v = float(v)
+                    except ValueError:
+                        # Keep as string (e.g., stop sequences or system prompts)
+                        pass 
+            params[k] = v
+            
+        return params
+
+
+    @staticmethod
+    def dispatch(args):
+        # 1. Start with context
+        context = vars(args).copy()
+
+        # 2. Logic for Logging / Debug using Component constants
+        # We check the debug flag and map it to our integer constants
+        target_level = Ollama.LOG_DEBUG if context.get('debug') else Dispatcher.DEFAULT_LOG_LEVEL
+        
+        # Set global logging level
+        logging.getLogger().setLevel(target_level)
+        logging.getLogger("httpx").setLevel(target_level)
+        
+        # Pass the integer level into the context so it hits the property setter
+        context['log_level'] = target_level
+
+        # 3. Dynamic Parameter Parsing
+        dynamic_params = Dispatcher.parse_params(context.pop('params', []))
+        context.update(dynamic_params)
+
+        # 4. Resolve Input Logic
+        if args.command == "query":
+            user_input = Dispatcher.resolve_prompt(args)
+            if not user_input:
+                print("Error: No prompt provided.", file=sys.stderr)
+                sys.exit(1)
+            context['input'] = user_input
+
+        # 5. Initialize Component
+        # At this point, context contains everything (debug, command, url, model, etc.)
+        api = Ollama(**context)
+
+        # 6. TELL OLLAMA TO OBFUSCATE THE PLUMBING
+        # This moves the argparse noise to private _attributes
+        api.obfuscate(['debug', 'command', 'input_file', 'prompt'])
+
+        # 7. Route Command
+        if args.command == "ping":
+            Dispatcher.handle_ping(api)
+        elif args.command == "info":
+            Dispatcher.handle_info(api)
+        elif args.command == "query":
+            Dispatcher.handle_query(api)
+        
+        return
+
+
+
+    @staticmethod
+    def resolve_prompt(args):
+        if getattr(args, 'input_file', None):
+            return Dispatcher.load_file(args.input_file)
+        prompt_val = getattr(args, 'prompt', None)
+        if prompt_val and prompt_val.startswith("@"):
+            return Dispatcher.load_file(prompt_val[1:])
+        return prompt_val
+
+    @staticmethod
+    def load_file(filepath):
+        try:
+            with open(filepath, 'r', encoding='utf-8') as f:
+                return f.read().strip()
+        except Exception as e:
+            print(f"Error loading {filepath}: {e}", file=sys.stderr)
+            sys.exit(1)
+
+    @staticmethod
+    def handle_ping(api):
+        status = "ONLINE" if api.ping() else "OFFLINE"
+        print(f"Status: {status} (Host: {api.url})")
+
+    @staticmethod
+    def handle_info(api):
+        data = api.info()
+
+        print("-" * 40)
+        print(f"Status  : {data['status']}")
+        print(f"Host    : {api.url}")
+        print(f"Model   : {api.model}")
+
+        print("-" * 40)
+        models_list = data.get('models', [])
+        print(f"Available Models: {len(models_list)}")
+        for m in models_list:
+            print(f"  - {m}")
+
+        print("-" * 40)
+        return
+
+    @staticmethod
+    def handle_query(api):
+        if not api.ping():
+            print(f"Error: Server {api.url} unreachable.", file=sys.stderr)
+            sys.exit(1)
+
+        # step() yields chunks; we print them in real-time
+        if api.log_level == api.LOG_DEBUG:
+            print(f"--- Inference: {api.model} ---")
+        for chunk in api.step():
+            print(chunk, end="", flush=True)
+        
+        print()
+        return 
+
+def get_parser():
+    parser = argparse.ArgumentParser(prog="owlmind")
+    
+    # Generate the helpers
+    param_list = ", ".join(Ollama.OLLAMA_PARAMS.keys())
+    param_help = f"Supports k=v; (k1=v1,k2=v2), or multiple flags. Options: {param_list}"
+
+    # Global arguments
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    parser.add_argument("--debug", action="store_true", help="Enable verbose telemetry and internal logs")
+    parser.add_argument("--url", dest="url", default=os.environ.get("OLLAMA_HOST", Ollama.DEFAULT_SERVER))
+    subparsers = parser.add_subparsers(dest="command", required=True)
+    
+    # ping / info
+    subparsers.add_parser("ping")
+    subparsers.add_parser("info")
+
+    # query
+    qp = subparsers.add_parser("query")
+    qp.add_argument("prompt", nargs="?", default=None)
+    qp.add_argument("--input", "-i", dest="input_file")
+    qp.add_argument("--model", "-m", default=os.environ.get("OLLAMA_MODEL", Ollama.DEFAULT_MODEL))
+    qp.add_argument("--params", "-p", action="append", dest="params", help=param_help)
+
+    return parser
+
+
+##
+## ENTRY POINT
+##
+
+def main():
+    Dispatcher.load_env()
+    parser = get_parser()
+    args = parser.parse_args()
+    Dispatcher.dispatch(args)
+
+
+##
+## EXECUTOR
+##
+if __name__ == "__main__":
+    main()

owlmind-0.1.5/src/owlmind/core/__init__.py

@@ -0,0 +1,9 @@
+"""
+OwlMind Framework - experimentation environment for Generative Intelligence Systems.
+"""
+
+from .component import Component
+
+__all__ = [
+    "Component"
+]

owlmind-0.1.5/src/owlmind/core/component.py

@@ -0,0 +1,87 @@
+##
+## OwlMind Framework - experimentation environment for Generative Intelligence Systems.
+## core/component.py — Abstract base definition for generative workflow components.
+##
+# Copyright (c) 2025, The Generative Intelligence Lab
+#    https://github.com/genilab/owlmind
+#
+# Disclosure:
+# This framework was developed using a 'vibe coding' . AI-synthesized logic was 
+# subjected to human review and manual refinement to guarantee functional 
+# integrity and structural clarity.
+#
+
+
+import logging
+from typing import Any, Iterator
+from abc import ABC, abstractmethod
+from owlmind.graphk import Node
+
+
+##
+## COMPONENT
+##
+
+class Component(Node, ABC):
+    """
+    Base class for framework components with managed I/O and logging.
+    """
+    
+    LOG_FORMAT = '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
+
+    # Log Levels as Constants
+    LOG_DEBUG = logging.DEBUG
+    LOG_INFO = logging.INFO
+    LOG_WARNING = logging.WARNING
+    LOG_ERROR = logging.ERROR
+    LOG_CRITICAL = logging.CRITICAL
+
+    def __init__(self, session: dict = None, log_level: int = LOG_CRITICAL, **kwargs):
+        # 1. Setup logging infrastructure
+        if not logging.getLogger().hasHandlers(): 
+            logging.basicConfig(level=logging.WARNING, format=self.LOG_FORMAT)
+        
+        # Internal framework storage using _name_ convention
+        self._logger_ = logging.getLogger(self.__class__.__name__)
+        self._input_ = None
+        self._output_ = None
+        
+        # Initialize Node (this handles _condition_, _weight_, etc.)
+        super().__init__(session=session, **kwargs)
+
+        # 2. Set the log level using the property setter
+        self.log_level = log_level
+
+        # 3. Obfuscate framework attributes to keep session() clean
+        self.obfuscate(['log_level'])
+
+        return
+
+    @property
+    def input(self): 
+        return self._input_
+
+    @input.setter
+    def input(self, value): 
+        self._input_ = value
+
+    @property
+    def output(self): 
+        return self._output_
+
+    @property
+    def log_level(self) -> int: 
+        return self._logger_.level
+
+    @log_level.setter
+    def log_level(self, level: Any):
+        val = getattr(logging, level.upper(), None) if isinstance(level, str) else level
+        if isinstance(val, int): 
+            self._logger_.setLevel(val)
+        return
+
+    def log(self, message: str, level: int = LOG_INFO): 
+        self._logger_.log(level, message)
+        return
+
+  

owlmind-0.1.5/src/owlmind/graphk/__init__.py

@@ -0,0 +1,12 @@
+"""
+GraphK - Framework for Graph programming.
+"""
+
+from .node import Node, Gate, BranchNode
+from .pipeline import Pipeline
+
+__all__ = [
+    "Node", 
+    "Gate", 
+    "BranchNode"
+]