syntaxmatrix 2.6.0__py3-none-any.whl → 2.6.1__py3-none-any.whl

syntaxmatrix/core.py

@@ -40,6 +40,9 @@ _CLIENT_DIR = detect_project_root()
 _HISTORY_DIR   = os.path.join(_CLIENT_DIR, "smx_history")
 os.makedirs(_HISTORY_DIR, exist_ok=True)
 
+_BRANDING_DIR = os.path.join(_CLIENT_DIR, "branding")
+os.makedirs(_BRANDING_DIR, exist_ok=True)
+
 _SECRET_PATH = os.path.join(_CLIENT_DIR, ".smx_secret_key")
 
 # OPENAI_API_KEY = getenv_api_key(_CLIENT_DIR, "OPENAI_API_KEY"))
@@ -72,6 +75,8 @@ class SyntaxMUI:
         self.bot_icon = bot_icon
         self.site_logo = site_logo
         self.favicon = favicon
+        self._default_site_logo = site_logo
+        self._default_favicon = favicon
         self.site_title = site_title
         self.project_name = project_name
         self.ui_mode = ui_mode
@@ -99,6 +104,9 @@ class SyntaxMUI:
         self._last_llm_usage = None 
         routes.setup_routes(self)
 
+        # Apply client branding overrides if present on disk
+        self._apply_branding_from_disk()
+
         # LLM Profiles
         self.admin_profile = {}
         self.chat_profile = {}
@@ -330,24 +338,49 @@ class SyntaxMUI:
         col_html += "</div>"
         return col_html
 
+    # Site Branding
     def set_site_title(self, title):
         self.site_title = title
-    
     def set_project_name(self, project_name):
         self.project_name = project_name
-
     def set_favicon(self, icon):
         self.favicon = icon
-
-
     def set_site_logo(self, logo):
         self.site_logo = logo
-
     def set_user_icon(self, icon):
         self.user_icon = icon
-
     def set_bot_icon(self, icon):
         self.bot_icon = icon
+    
+    def _apply_branding_from_disk(self):
+        """
+        If a client logo/favicon exists in syntaxmatrixdir/branding/,
+        use it; otherwise keep the framework defaults.
+        """
+        branding_dir = os.path.join(_CLIENT_DIR, "branding")
+
+        def _pick(basename: str):
+            for ext in (".png", ".jpg", ".jpeg"):
+                fn = f"{basename}{ext}"
+                p = os.path.join(branding_dir, fn)
+                if os.path.exists(p):
+                    return fn
+            return None
+
+        logo_fn = _pick("logo")
+        fav_fn = _pick("favicon")
+
+        if logo_fn:
+            # Use client-served endpoint (added in routes.py below)
+            self.site_logo = f"<img src='/branding/{logo_fn}' width='45' alt='logo'/>"
+        else:
+            self.site_logo = getattr(self, "_default_site_logo", self.site_logo)
+
+        if fav_fn:
+            self.favicon = f"/branding/{fav_fn}"
+        else:
+            self.favicon = getattr(self, "_default_favicon", self.favicon)
+
 
     def text_input(self, key, id, label, placeholder=""):
         if not placeholder:

syntaxmatrix/routes.py

@@ -4508,8 +4508,8 @@ def setup_routes(smx):
         #  SYSTEM FILES
         # ────────────────────────────────────────────────────────────────────────────────
         sys_files_card = f"""
-          <div class="card span-4">
-            <h4>Upload System Files (PDFs only)</h4>
+          <div class="card span-3">
+            <h4>Upload System Files<br>(PDFs only)</h4>
             <form id="form-upload" method="post" enctype="multipart/form-data" style="display:inline-block;">
               <input type="file" name="upload_files" accept=".pdf" multiple>
               <button type="submit" name="action" value="upload_files">Upload</button>
@@ -4540,7 +4540,7 @@ def setup_routes(smx):
             """
 
         manage_sys_files_card = f"""
-          <div class='card span-4'>
+          <div class='card span-3'>
             <h4>Manage Company Files</h4>
             <ul class="catalog-list" style="list-style:none; padding-left:0; margin:0;">
               {sys_files_html or "<li>No company file has been uploaded yet.</li>"}
@@ -4964,7 +4964,7 @@ def setup_routes(smx):
             pixabay_saved = bool(os.environ.get("PIXABAY_API_KEY"))
 
         secretes_link_card = f"""
-          <div class="card span-4">
+          <div class="card span-3">
             <h4>Integrations (Secrets)</h4>
             <div style="font-size:.72rem;color:#555;margin-top:-6px;margin-bottom:10px;line-height:1.35;">
               Store secrete credentials.
@@ -4973,17 +4973,28 @@ def setup_routes(smx):
           </div>
         """
 
+        branding_link_card = f"""
+          <div class="card span-3">
+            <h4>Branding</h4>
+            <div style="font-size:.72rem;color:#555;margin-top:-6px;margin-bottom:10px;line-height:1.35;">
+              Upload your company logo and favicon (PNG/JPG). Defaults are used if nothing is uploaded.
+            </div>
+            <a href="{url_for('admin_branding')}" class="btn">Manage branding</a>
+          </div>
+        """
+
         system_section = f"""
           <section id="system" class="section">
             <h2>System</h2>
             <div class="admin-grid">
               {secretes_link_card}
+              {branding_link_card}
               {sys_files_card}
               {manage_sys_files_card}
             </div>
+
           </section>
         """
-
         users_section = f"""
           <section id="users" class="section">
             <h2>Users</h2>
@@ -5518,6 +5529,114 @@ def setup_routes(smx):
         return render_template("admin_secretes.html", secret_names=names)
 
 
+    @smx.app.route("/admin/branding", methods=["GET", "POST"])
+    @admin_required
+    def admin_branding():
+        branding_dir = os.path.join(_CLIENT_DIR, "branding")
+        os.makedirs(branding_dir, exist_ok=True)
+
+        allowed_ext = {".png", ".jpg", ".jpeg"}
+        max_logo_bytes = 5 * 1024 * 1024      # 5 MB
+        max_favicon_bytes = 1 * 1024 * 1024   # 1 MB
+
+        def _find(base: str):
+            for ext in (".png", ".jpg", ".jpeg"):
+                p = os.path.join(branding_dir, f"{base}{ext}")
+                if os.path.exists(p):
+                    return f"{base}{ext}"
+            return None
+
+        def _delete_all(base: str):
+            for ext in (".png", ".jpg", ".jpeg"):
+                p = os.path.join(branding_dir, f"{base}{ext}")
+                if os.path.exists(p):
+                    try:
+                        os.remove(p)
+                    except Exception:
+                        pass
+
+        def _save_upload(field_name: str, base: str, max_bytes: int):
+            f = request.files.get(field_name)
+            if not f or not f.filename:
+                return False, None
+
+            ext = os.path.splitext(f.filename.lower())[1].strip()
+            if ext not in allowed_ext:
+                return False, f"Invalid file type for {base}. Use PNG or JPG."
+
+            # size check
+            try:
+                f.stream.seek(0, os.SEEK_END)
+                size = f.stream.tell()
+                f.stream.seek(0)
+            except Exception:
+                size = None
+
+            if size is not None and size > max_bytes:
+                return False, f"{base.capitalize()} is too large. Max {max_bytes // (1024*1024)} MB."
+
+            # Replace existing logo.* / favicon.*
+            _delete_all(base)
+
+            out_path = os.path.join(branding_dir, f"{base}{ext}")
+            try:
+                f.save(out_path)
+            except Exception as e:
+                return False, f"Failed to save {base}: {e}"
+
+            return True, None
+
+        # POST actions
+        if request.method == "POST":
+            action = (request.form.get("action") or "upload").strip().lower()
+
+            if action == "reset":
+                _delete_all("logo")
+                _delete_all("favicon")
+                try:
+                    smx._apply_branding_from_disk()
+                except Exception:
+                    pass
+                flash("Branding reset to defaults ✓")
+                return redirect(url_for("admin_branding"))
+
+            ok1, err1 = _save_upload("logo_file", "logo", max_logo_bytes)
+            ok2, err2 = _save_upload("favicon_file", "favicon", max_favicon_bytes)
+
+            if err1:
+                flash(err1, "error")
+            if err2:
+                flash(err2, "error")
+
+            if ok1 or ok2:
+                try:
+                    smx._apply_branding_from_disk()
+                except Exception:
+                    pass
+                flash("Branding updated ✓")
+
+            return redirect(url_for("admin_branding"))
+
+        # GET: show current status
+        logo_fn = _find("logo")
+        fav_fn = _find("favicon")
+
+        cache_bust = int(time.time())
+
+        logo_url = f"/branding/{logo_fn}?v={cache_bust}" if logo_fn else None
+        favicon_url = f"/branding/{fav_fn}?v={cache_bust}" if fav_fn else None
+
+        default_logo_html = getattr(smx, "_default_site_logo", smx.site_logo)
+        default_favicon_url = getattr(smx, "_default_favicon", smx.favicon)
+
+        return render_template(
+            "admin_branding.html",
+            logo_url=logo_url,
+            favicon_url=favicon_url,
+            default_logo_html=Markup(default_logo_html),
+            default_favicon_url=default_favicon_url,
+        )
+
     @smx.app.route("/admin/delete.json", methods=["POST"])
     def admin_delete_universal():
 
@@ -6407,13 +6526,20 @@ def setup_routes(smx):
 
         return jsonify({"file_paths": file_paths})
     
-
+  
     # Serve the raw media files
     @smx.app.route('/uploads/media/<path:filename>')
     def serve_media(filename):
         media_dir = os.path.join(_CLIENT_DIR, 'uploads', 'media')
         return send_from_directory(media_dir, filename)
     
+
+    @smx.app.route("/branding/<path:filename>")
+    def serve_branding(filename):
+        branding_dir = os.path.join(_CLIENT_DIR, "branding")
+        return send_from_directory(branding_dir, filename)
+
+
     # ──────────────────────────────────────────────────────────────────────────────────────── 
     # DASHBOARD
     # ──────────────────────────────────────────────────────────────────────────────────────── 

syntaxmatrix/templates/admin_branding.html

@@ -0,0 +1,104 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Branding</title>
+  <style>
+    body{font-family:system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;margin:0;background:#0b1224;color:#e5e7eb;}
+    .wrap{max-width:980px;margin:0 auto;padding:18px;}
+    .top{display:flex;align-items:center;justify-content:space-between;gap:10px;margin-bottom:14px;}
+    .top h1{margin:0;font-size:1.1rem;}
+    .btn{display:inline-block;padding:8px 12px;border-radius:999px;border:1px solid rgba(148,163,184,.35);color:#e5e7eb;text-decoration:none;background:transparent;cursor:pointer;font-weight:650;font-size:.85rem;}
+    .btn:hover{border-color:rgba(56,189,248,.6);color:#38bdf8;}
+    .card{background:rgba(2,6,23,.65);border:1px solid rgba(148,163,184,.25);border-radius:14px;padding:14px;box-shadow:0 18px 36px rgba(15,23,42,.6);margin-bottom:12px;}
+    label{display:block;font-size:.78rem;font-weight:750;margin-bottom:6px;color:#d1d5db;}
+    input[type="file"]{width:100%;padding:10px 11px;border-radius:12px;border:1px solid rgba(148,163,184,.25);background:rgba(2,6,23,.8);color:#e5e7eb;outline:none;}
+    .row{display:grid;grid-template-columns:1fr 1fr;gap:10px;}
+    @media (max-width:760px){.row{grid-template-columns:1fr;}}
+    .hint{color:#9ca3af;font-size:.78rem;line-height:1.35;margin-top:8px;}
+    .flash{background:rgba(34,197,94,.12);border:1px solid rgba(34,197,94,.35);padding:10px;border-radius:12px;margin-bottom:10px;color:#bbf7d0;font-size:.85rem;}
+    .flash.warn{background:rgba(239,68,68,.10);border-color:rgba(239,68,68,.30);color:#fecaca;}
+    .preview{display:flex;gap:14px;align-items:center;flex-wrap:wrap;margin-top:10px;}
+    .chip{padding:6px 10px;border-radius:999px;border:1px solid rgba(148,163,184,.25);font-size:.8rem;color:#cbd5e1;}
+    .danger{border-color:rgba(239,68,68,.55);color:#fecaca;}
+    .danger:hover{border-color:rgba(239,68,68,.9);color:#fff;}
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="top">
+      <h1>Branding</h1>
+      <a class="btn" href="{{ url_for('admin_panel') }}#system">Back to Admin</a>
+    </div>
+
+    {% with messages = get_flashed_messages(with_categories=True) %}
+      {% if messages %}
+        {% for cat, m in messages %}
+          <div class="flash {{ 'warn' if cat == 'error' else '' }}">{{ m }}</div>
+        {% endfor %}
+      {% endif %}
+    {% endwith %}
+
+    <div class="card">
+      <h2 style="margin:0 0 10px;font-size:.95rem;">Upload logo and favicon</h2>
+
+      <form method="post" enctype="multipart/form-data">
+        <input type="hidden" name="action" value="upload">
+
+        <div class="row">
+          <div>
+            <label>Logo (PNG/JPG)</label>
+            <input type="file" name="logo_file" accept=".png,.jpg,.jpeg,image/png,image/jpeg">
+            <div class="hint">Tip: a wide logo works best. Up to 5 MB.</div>
+          </div>
+
+          <div>
+            <label>Favicon (PNG/JPG)</label>
+            <input type="file" name="favicon_file" accept=".png,.jpg,.jpeg,image/png,image/jpeg">
+            <div class="hint">Tip: square image (32×32 or 48×48). Up to 1 MB.</div>
+          </div>
+        </div>
+
+        <div style="margin-top:12px;display:flex;justify-content:flex-end;gap:10px;">
+          <button class="btn" type="submit">Save</button>
+        </div>
+      </form>
+
+      <div class="preview">
+        <div>
+          <div class="chip">Current logo</div>
+          <div style="margin-top:8px;">
+            {% if logo_url %}
+              <img src="{{ logo_url }}" alt="logo" style="max-height:44px;max-width:240px;">
+            {% else %}
+              {{ default_logo_html|safe }}
+            {% endif %}
+          </div>
+        </div>
+
+        <div>
+          <div class="chip">Current favicon</div>
+          <div style="margin-top:8px;">
+            {% if favicon_url %}
+              <img src="{{ favicon_url }}" alt="favicon" style="width:32px;height:32px;border-radius:6px;">
+            {% else %}
+              <img src="{{ default_favicon_url }}" alt="favicon" style="width:32px;height:32px;border-radius:6px;">
+            {% endif %}
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <div class="card">
+      <h2 style="margin:0 0 10px;font-size:.95rem;">Reset</h2>
+      <div class="hint">Removes the uploaded logo/favicon so the app falls back to the SyntaxMatrix defaults.</div>
+
+      <form method="post" onsubmit="return confirm('Reset branding to defaults?');" style="margin-top:10px;">
+        <input type="hidden" name="action" value="reset">
+        <button class="btn danger" type="submit">Reset to defaults</button>
+      </form>
+    </div>
+  </div>
+</body>
+</html>

{syntaxmatrix-2.6.0.dist-info → syntaxmatrix-2.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syntaxmatrix
-Version: 2.6.0
+Version: 2.6.1
 Summary: SyntaxMUI: A customizable framework for Python AI Assistant Projects.
 Author: Bob Nti
 Author-email: bob.nti@syntaxmatrix.net

{syntaxmatrix-2.6.0.dist-info → syntaxmatrix-2.6.1.dist-info}/RECORD

@@ -2,7 +2,7 @@ syntaxmatrix/__init__.py,sha256=_LnTrYAW2tbYA37Y233Vv4OMOk8NUnoJi-1yzFyHxEI,2573
 syntaxmatrix/auth.py,sha256=SCD6uWojXjj9yjUTKzgV5kBYe6ZkXASEG2VopLFkEtM,18140
 syntaxmatrix/bootstrap.py,sha256=Y7ZNg-Z3ecrr1iYem5EMzPmGstXnEKmO9kqKVoOoljo,817
 syntaxmatrix/commentary.py,sha256=3c8qBAKJI2IcYd9PBZrFEwmv-c4_tfa3ebEoPa5vW7U,12428
-syntaxmatrix/core.py,sha256=5K90R2gW3WmW6zE9QMecn5YEp1lqpFGUp84QSl3iJNQ,63141
+syntaxmatrix/core.py,sha256=8xZgXO2F0QXsLimxGujJY7Qnpfw849MQOuLO0RxsMN4,64489
 syntaxmatrix/dataset_preprocessing.py,sha256=wtV4MWzkyfOsBHTsS0H1gqHho77ZQHGDI9skJryyZWA,8732
 syntaxmatrix/db.py,sha256=utS_nUIoTspuLV9hgrpg0jdMiqAVHe9Ho0U46GFWdyE,18921
 syntaxmatrix/display_html.py,sha256=tBeeHcRbmAOKqRTXY0hUehThFspCDsvjW4myi2zj0iU,3568
@@ -21,7 +21,7 @@ syntaxmatrix/plottings.py,sha256=MjHQ9T1_oC5oyr4_wkM2GJDrpjp0sbvudbs2lGaMyzk,610
 syntaxmatrix/preface.py,sha256=tCm0C0BhY_SOntQT5I7cOJr6TB5mVDAeL9i8UmHLu5g,21237
 syntaxmatrix/profiles.py,sha256=hPg27IQjl8-Tpo3BanQQsByeAgcizqIA2I_IKKNZ0TI,2900
 syntaxmatrix/project_root.py,sha256=1ckvbFVV1szHtHsfSCoGcImHkRwbfszmPG1kGh9ZZlE,2227
-syntaxmatrix/routes.py,sha256=EtcjTM_UZhWRkrGuGX2DMZtEA8p4HyXnchiYyBeqXAg,348603
+syntaxmatrix/routes.py,sha256=hA2uc4rvxGURkZJET9Nvcmt5vAljkWO7uKPYEOvrPXM,353176
 syntaxmatrix/selftest_page_templates.py,sha256=JY1i2xu7FBkN0TIPiAXhEk_iIjdOBmfc1g9aX98iqhw,14833
 syntaxmatrix/session.py,sha256=v0qgxnVM_LEaNvZQJSa-13Q2eiwc3RDnjd2SahNnHQk,599
 syntaxmatrix/smiv.py,sha256=1lSN3UYpXvYoVNd6VrkY5iZuF_nDxD6xxvLnTn9wcbQ,1405
@@ -53,13 +53,13 @@ syntaxmatrix/static/css/style.css,sha256=20QHPm9qlHhFh5lE_epMw1ehgmZL3lDv7bZhcor
 syntaxmatrix/static/icons/bot-icon.png,sha256=ttOEMukAeFPhmHPAhvscaV8AiYFqn_YJ0it850bR454,2811
 syntaxmatrix/static/icons/favicon.png,sha256=qRs_FleJwo4VfNRxGn3rRT8kypRRbDHZBSXuVXcRJVA,9895
 syntaxmatrix/static/icons/logo.png,sha256=FGwH-vhx7gSmwiKkPfP1_6Mq9VGxscaXkZSKsX6o3-M,67536
-syntaxmatrix/static/icons/logo2.png,sha256=dHLC1AppEKI9dnDpsdi2elgybzAiwYg213aaW_Ymspo,67307
 syntaxmatrix/static/icons/logo3.png,sha256=l_9Px0P1uJOFKpKC8kISdwcpKafZF2GXCmCXQV-Zw6c,12467
 syntaxmatrix/static/icons/svg_497526.svg,sha256=q1psnT8mW1nItUPLrqkWkwQmAvKaMoz4OSUlGVjeD4Q,672
 syntaxmatrix/static/icons/svg_497528.svg,sha256=tr6h370kTqDUfyCrByGjrjNBh2iKwBUOQUnh2unqZZA,670
 syntaxmatrix/static/js/chat.js,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/static/js/sidebar.js,sha256=zHp4skKLY2Dlqx7aLPQ8_cR0iTRT17W0SC2TR38Yl64,7609
 syntaxmatrix/static/js/widgets.js,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+syntaxmatrix/templates/admin_branding.html,sha256=uoYgF3Si3BHusXWqwn_A6VVkqxBt3FXGw2YepLdOgTc,4839
 syntaxmatrix/templates/admin_secretes.html,sha256=lG8NpJSokdC27SZTLo0j2fHpbukts2-lgJyqyWnqCu8,4973
 syntaxmatrix/templates/change_password.html,sha256=YWEcnwJLccLyKGzQxIrc0xuP-p00BtEIwcYq4oFvJ-0,3332
 syntaxmatrix/templates/code_cell.html,sha256=LOr9VjvNQcOGKKJ1ecpcZh3C3qsUxBHueg2iQtpdxl8,638
@@ -77,8 +77,8 @@ syntaxmatrix/vectordb/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5
 syntaxmatrix/vectordb/adapters/milvus_adapter.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/vectordb/adapters/pgvector_adapter.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syntaxmatrix/vectordb/adapters/sqlite_adapter.py,sha256=L8M2qHfwZRAFVxWeurUVdHaJXz6F5xTUSWh3uy6TSUs,6035
-syntaxmatrix-2.6.0.dist-info/licenses/LICENSE.txt,sha256=j1P8naTdy1JMxTC80XYQjbyAQnuOlpDusCUhncrvpy8,1083
-syntaxmatrix-2.6.0.dist-info/METADATA,sha256=GyMfWvS06j3sMhiZx8hc5WYIb4JolTtCPukL1DoRo50,18219
-syntaxmatrix-2.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-syntaxmatrix-2.6.0.dist-info/top_level.txt,sha256=HKP_zkl4V_nt7osC15DlacoBZktHrbZYOqf_pPkF3T8,13
-syntaxmatrix-2.6.0.dist-info/RECORD,,
+syntaxmatrix-2.6.1.dist-info/licenses/LICENSE.txt,sha256=j1P8naTdy1JMxTC80XYQjbyAQnuOlpDusCUhncrvpy8,1083
+syntaxmatrix-2.6.1.dist-info/METADATA,sha256=R9QuWYbRtdKs6ZBit1f2DKJaSEL4ONXeI1UCYJl9eE8,18219
+syntaxmatrix-2.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+syntaxmatrix-2.6.1.dist-info/top_level.txt,sha256=HKP_zkl4V_nt7osC15DlacoBZktHrbZYOqf_pPkF3T8,13
+syntaxmatrix-2.6.1.dist-info/RECORD,,