syntaxmatrix-core 1.0.0__tar.gz

syntaxmatrix_core-1.0.0/MANIFEST.in

@@ -0,0 +1,14 @@
+prune admin_tools
+prune tools
+prune build
+prune dist
+
+global-exclude *.py[cod]
+global-exclude __pycache__
+global-exclude .DS_Store
+
+
+prune admin_tools
+prune tools
+prune build
+prune dist

syntaxmatrix_core-1.0.0/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: syntaxmatrix-core
+Version: 1.0.0
+Summary: SyntaxMatrix: A Framework for  building owned AI Platform.
+Author: Bob Nti
+Author-email: info@syntaxmatrix.net
+License: MIT
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: Flask>=3.0.3
+Requires-Dist: requests>=2.32.3
+Requires-Dist: pytz<2026,>=2025.2
+Requires-Dist: Markdown>=3.7
+Requires-Dist: pypdf>=5.4.0
+Requires-Dist: PyPDF2==3.0.1
+Requires-Dist: nest-asyncio>=1.6.0
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: openai>=1.84.0
+Requires-Dist: google-genai>=1.19.0
+Requires-Dist: anthropic>=0.67.0
+Requires-Dist: reportlab>=4.4.3
+Requires-Dist: lxml>=6.0.2
+Requires-Dist: flask-login>=0.6.3
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: numpy>=2.0.2
+Requires-Dist: matplotlib>=3.9.4
+Requires-Dist: plotly>=6.3.0
+Requires-Dist: seaborn>=0.13.2
+Requires-Dist: scikit-learn>=1.6.1
+Requires-Dist: jupyter_client>=8.6.3
+Requires-Dist: ipykernel>=6.29.5
+Requires-Dist: ipython
+Requires-Dist: statsmodels
+Requires-Dist: sqlalchemy>=2.0.42
+Requires-Dist: cryptography>=45.0.6
+Requires-Dist: regex>=2025.11.3
+Requires-Dist: tiktoken>=0.12.0
+Requires-Dist: xgboost>=2.1.4
+Requires-Dist: beautifulsoup4>=4.12.2
+Requires-Dist: html5lib>=1.1
+Requires-Dist: shap>=0.42.0
+Requires-Dist: gunicorn==22.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+SyntaxMatrix Platform Provisioner (SPP)
+
+SyntaxMatrix Platform Provisioner (SPP) is a self-hosted AI platform framework for building, deploying, and operating production-grade AI applications with licensing, governance, and modular extensibility built in.
+
+SPP is designed for developers, educators, research teams, and enterprises who need full control over their AI systems while retaining a clear upgrade path to commercial capabilities.
+
+What is SyntaxMatrix Platform Provisioner?
+
+SPP is an open-core platform provisioner that enables organisations to:
+
+Deploy AI-powered web applications
+
+Provision AI assistants, ML tooling, and admin panels
+
+Enforce feature access via licensing
+
+Maintain full data ownership and self-hosting control
+
+Each client runs their own independent instance.
+SyntaxMatrix does not host or operate client environments.
+
+Key Capabilities
+
+Self-Hosted AI Platform
+Deploy on your own infrastructure (cloud or on-prem).
+
+Modular Architecture
+Enable or disable platform capabilities via entitlements.
+
+Licensing & Entitlements
+Commercial features are controlled through a secure licence system.
+
+Admin Panel & Governance
+Manage users, content, data ingestion, and configuration.
+
+AI & ML Tooling
+Built-in support for AI assistants, retrieval, analytics, and experimentation.
+
+Production-Ready
+Designed for real deployments, not demos.
+
+Open-Core Model
+
+SyntaxMatrix Platform Provisioner follows an open-core approach:
+
+Core framework → MIT Licence
+
+Premium features → Commercial Licence
+
+This allows you to:
+
+Start freely
+
+Self-host fully
+
+Upgrade only when advanced capabilities are required
+
+Licensing Overview
+Open-Source Components (MIT)
+
+The core platform is released under the MIT Licence, allowing:
+
+Commercial use
+
+Modification
+
+Redistribution
+
+Commercial Licence (Required for Premium Features)
+
+Certain features require a paid subscription, including (but not limited to):
+
+Advanced AI modules
+
+Enterprise-grade limits
+
+Premium admin capabilities
+
+Commercial support tooling
+
+Licence enforcement features
+
+Commercial features are governed by the SyntaxMatrix Commercial Licence Agreement.
+
+Using Premium Features without a valid licence is not permitted.
+
+Subscription & Billing
+
+Subscriptions are managed via Stripe
+
+Licences are validated remotely
+
+Paid plans take effect immediately
+
+Cancellation applies at the end of the billing period
+
+Grace periods may apply for payment issues
+
+All enforcement is automated and transparent.
+
+Self-Hosting Philosophy
+
+SyntaxMatrix is built on a client-owned infrastructure model:
+
+You deploy your own instance
+
+You own your data
+
+You control your environment
+
+You choose when (and if) to upgrade
+
+This architecture is intentional and central to the product’s design.
+
+Typical Use Cases
+
+AI education platforms
+
+Internal enterprise AI tools
+
+Research environments
+
+AI-powered dashboards
+
+Multi-tenant AI services
+
+Regulated or privacy-sensitive deployments
+
+Installation
+
+SPP is distributed via PyPI.
+
+Installation details are intentionally minimal here to avoid coupling the README to internal APIs.
+Full setup instructions are provided in the official documentation.
+
+Documentation
+
+Comprehensive documentation covers:
+
+Architecture & design
+
+Licensing model
+
+Deployment workflows
+
+Client-side integration
+
+Security considerations
+
+Documentation is provided separately and kept version-aligned with releases.
+
+Support & Contact
+
+Website: https://syntaxmatrix.com
+
+Licensing: licence@syntaxmatrix.com
+
+Commercial enquiries: info@syntaxmatrix.com
+
+Legal
+
+© SyntaxMatrix Limited
+All rights reserved.
+
+Use of Premium Features requires a valid commercial subscription.

syntaxmatrix_core-1.0.0/README.md

@@ -0,0 +1,165 @@
+SyntaxMatrix Platform Provisioner (SPP)
+
+SyntaxMatrix Platform Provisioner (SPP) is a self-hosted AI platform framework for building, deploying, and operating production-grade AI applications with licensing, governance, and modular extensibility built in.
+
+SPP is designed for developers, educators, research teams, and enterprises who need full control over their AI systems while retaining a clear upgrade path to commercial capabilities.
+
+What is SyntaxMatrix Platform Provisioner?
+
+SPP is an open-core platform provisioner that enables organisations to:
+
+Deploy AI-powered web applications
+
+Provision AI assistants, ML tooling, and admin panels
+
+Enforce feature access via licensing
+
+Maintain full data ownership and self-hosting control
+
+Each client runs their own independent instance.
+SyntaxMatrix does not host or operate client environments.
+
+Key Capabilities
+
+Self-Hosted AI Platform
+Deploy on your own infrastructure (cloud or on-prem).
+
+Modular Architecture
+Enable or disable platform capabilities via entitlements.
+
+Licensing & Entitlements
+Commercial features are controlled through a secure licence system.
+
+Admin Panel & Governance
+Manage users, content, data ingestion, and configuration.
+
+AI & ML Tooling
+Built-in support for AI assistants, retrieval, analytics, and experimentation.
+
+Production-Ready
+Designed for real deployments, not demos.
+
+Open-Core Model
+
+SyntaxMatrix Platform Provisioner follows an open-core approach:
+
+Core framework → MIT Licence
+
+Premium features → Commercial Licence
+
+This allows you to:
+
+Start freely
+
+Self-host fully
+
+Upgrade only when advanced capabilities are required
+
+Licensing Overview
+Open-Source Components (MIT)
+
+The core platform is released under the MIT Licence, allowing:
+
+Commercial use
+
+Modification
+
+Redistribution
+
+Commercial Licence (Required for Premium Features)
+
+Certain features require a paid subscription, including (but not limited to):
+
+Advanced AI modules
+
+Enterprise-grade limits
+
+Premium admin capabilities
+
+Commercial support tooling
+
+Licence enforcement features
+
+Commercial features are governed by the SyntaxMatrix Commercial Licence Agreement.
+
+Using Premium Features without a valid licence is not permitted.
+
+Subscription & Billing
+
+Subscriptions are managed via Stripe
+
+Licences are validated remotely
+
+Paid plans take effect immediately
+
+Cancellation applies at the end of the billing period
+
+Grace periods may apply for payment issues
+
+All enforcement is automated and transparent.
+
+Self-Hosting Philosophy
+
+SyntaxMatrix is built on a client-owned infrastructure model:
+
+You deploy your own instance
+
+You own your data
+
+You control your environment
+
+You choose when (and if) to upgrade
+
+This architecture is intentional and central to the product’s design.
+
+Typical Use Cases
+
+AI education platforms
+
+Internal enterprise AI tools
+
+Research environments
+
+AI-powered dashboards
+
+Multi-tenant AI services
+
+Regulated or privacy-sensitive deployments
+
+Installation
+
+SPP is distributed via PyPI.
+
+Installation details are intentionally minimal here to avoid coupling the README to internal APIs.
+Full setup instructions are provided in the official documentation.
+
+Documentation
+
+Comprehensive documentation covers:
+
+Architecture & design
+
+Licensing model
+
+Deployment workflows
+
+Client-side integration
+
+Security considerations
+
+Documentation is provided separately and kept version-aligned with releases.
+
+Support & Contact
+
+Website: https://syntaxmatrix.com
+
+Licensing: licence@syntaxmatrix.com
+
+Commercial enquiries: info@syntaxmatrix.com
+
+Legal
+
+© SyntaxMatrix Limited
+All rights reserved.
+
+Use of Premium Features requires a valid commercial subscription.

syntaxmatrix_core-1.0.0/pyproject.toml

@@ -0,0 +1,4 @@
+# pyproject.toml
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

syntaxmatrix_core-1.0.0/setup.cfg

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

syntaxmatrix_core-1.0.0/setup.py

@@ -0,0 +1,71 @@
+from setuptools import setup, find_packages
+import os
+
+# Read the README for a detailed project description
+this_directory = os.path.abspath(os.path.dirname(__file__))
+with open(os.path.join(this_directory, "README.md"), encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="syntaxmatrix-core",
+    version="1.0.0",
+    license="MIT",
+    classifiers=[
+        "Operating System :: OS Independent",
+    ],
+    author="Bob Nti",
+    author_email="info@syntaxmatrix.net",
+    description="SyntaxMatrix: A Framework for  building owned AI Platform.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    python_requires='>=3.9',
+    packages=find_packages(
+        exclude=[
+            "admin_tools", "admin_tools.*",
+            "tools", "tools.*",
+        ],
+    ),
+
+    include_package_data=True,
+    package_data={
+        "syntaxmatrix": [
+            "static/**/*",
+            "templates/*",      
+        ]
+    },
+    install_requires=[
+        "Flask>=3.0.3",
+        "requests>=2.32.3",
+        "pytz>=2025.2,<2026",
+        "Markdown>=3.7",
+        "pypdf>=5.4.0",
+        "PyPDF2==3.0.1",          
+        "nest-asyncio>=1.6.0",   
+        "python-dotenv>=1.1.0",  
+        "openai>=1.84.0",
+        "google-genai>=1.19.0",
+        "anthropic>=0.67.0",
+        "reportlab>=4.4.3",
+        "lxml>=6.0.2",
+        "flask-login>=0.6.3",
+        "pandas>=2.2.3",
+        "numpy>=2.0.2",
+        "matplotlib>=3.9.4",
+        "plotly>=6.3.0",
+        "seaborn>=0.13.2",
+        "scikit-learn>=1.6.1",
+        "jupyter_client>=8.6.3",
+        "ipykernel>=6.29.5",
+        "ipython",
+        "statsmodels",
+        "sqlalchemy>=2.0.42",
+        "cryptography>=45.0.6",
+        "regex>=2025.11.3", 
+        "tiktoken>=0.12.0",
+        "xgboost>=2.1.4",
+        "beautifulsoup4>=4.12.2",
+        "html5lib>=1.1",
+        "shap>=0.42.0",
+        "gunicorn==22.0.0",        
+    ],
+)

syntaxmatrix_core-1.0.0/syntaxmatrix/__init__.py

@@ -0,0 +1,66 @@
+from .core import SyntaxMUI
+
+_app_instance = SyntaxMUI()
+
+run = _app_instance.run
+text_input = _app_instance.text_input
+button = _app_instance.button
+file_uploader = _app_instance.file_uploader
+set_ui_mode = _app_instance.set_ui_mode
+set_theme = _app_instance.set_theme
+enable_theme_toggle = _app_instance.enable_theme_toggle
+get_text_input_value = _app_instance.get_text_input_value
+clear_text_input_value = _app_instance.clear_text_input_value
+get_file_upload_value = _app_instance.get_file_upload_value
+get_chat_history = _app_instance.get_chat_history
+set_chat_history = _app_instance.set_chat_history
+clear_chat_history = _app_instance.clear_chat_history
+write = _app_instance.write
+error = _app_instance.error
+success = _app_instance.success
+info = _app_instance.info
+warning = _app_instance.warning
+plt_plot = _app_instance.plt_plot
+plotly_plot = _app_instance.plotly_plot
+
+set_user_icon = _app_instance.set_user_icon
+set_bot_icon = _app_instance.set_bot_icon
+set_favicon = _app_instance.set_favicon
+set_project_name = _app_instance.set_project_name
+set_site_title = _app_instance.set_site_title
+set_site_logo = _app_instance.set_site_logo
+get_ui_modes = _app_instance.get_ui_modes
+get_themes = _app_instance.get_themes
+load_sys_chunks = _app_instance.load_sys_chunks
+
+get_session_id = _app_instance.get_session_id
+add_user_chunks = _app_instance.add_user_chunks
+get_user_chunks = _app_instance.get_user_chunks
+clear_user_chunks = _app_instance.clear_user_chunks
+set_plottings = _app_instance.set_plottings
+dropdown = _app_instance.dropdown
+get_widget_value = _app_instance.get_widget_value
+
+save_embed_model = _app_instance.save_embed_model
+load_embed_model = _app_instance.load_embed_model
+delete_embed_key = _app_instance.delete_embed_key
+set_smxai_identity = _app_instance.set_smxai_identity
+set_smxai_instructions = _app_instance.set_smxai_instructions
+set_website_description = _app_instance.set_website_description
+smiv_index = _app_instance.smiv_index
+smpv_search  = _app_instance.smpv_search
+stream_process_query= _app_instance.stream_process_query
+process_query_stream = _app_instance.process_query_stream
+process_query = _app_instance.process_query
+embed_query = _app_instance.embed_query
+stream_write = _app_instance.stream_write
+enable_stream = _app_instance.enable_stream
+stream = _app_instance.stream
+get_stream_args = _app_instance.get_stream_args
+enable_user_files = _app_instance.enable_user_files
+enable_registration = _app_instance.enable_registration
+enable_site_documentation = _app_instance.enable_site_documentation
+enable_ml_lab = _app_instance.enable_ml_lab
+
+
+app = _app_instance.app

syntaxmatrix_core-1.0.0/syntaxmatrix/agentic/agent_tools.py

@@ -0,0 +1,24 @@
+# syntaxmatrix/agent_tools.py
+from dataclasses import dataclass
+from typing import Callable, Optional, Dict, Any, List, Literal
+
+Phase = Literal["sanitize_early", "domain_patches", "syntax_fixes", "final_repair"]
+
+@dataclass
+class CodeTool:
+    name: str
+    phase: Phase
+    fn: Callable[[str, Dict[str, Any]], str]
+    when: Optional[Callable[[str, Dict[str, Any]], bool]] = None
+    priority: int = 100  # lower runs earlier within the phase
+
+class ToolRunner:
+    def __init__(self, tools: List[CodeTool]):
+        # stable order: phase → priority → name
+        self.tools = sorted(tools, key=lambda t: (t.phase, t.priority, t.name))
+
+    def run(self, code: str, ctx: Dict[str, Any]) -> str:
+        for t in self.tools:
+            if t.when is None or t.when(code, ctx):
+                code = t.fn(code, ctx)
+        return code