AIO public showcase bundle

LICENSE.txt

@@ -0,0 +1,8 @@
+AIO SYSTEM CORE - PUBLIC SHOWCASE LICENSE
+
+- Libera per uso e studio.
+- Uso commerciale NON consentito senza autorizzazione scritta.
+- Per richieste commerciali: info@rthitalia.com
+
+Nota:
+Questa showcase pubblica non trasferisce diritti sul know-how interno o sul corpus proprietario completo.

README.md

@@ -0,0 +1,55 @@
+---
+license: cc-by-nc-4.0
+language:
+  - it
+  - en
+tags:
+  - local-first
+  - offline
+  - knowledge-engine
+  - showcase
+  - privacy-focused
+  - retrieval
+pipeline_tag: text-retrieval
+---
+
+# AIO System Core - Public Showcase
+
+Questo repository e una **showcase pubblica** di AIO System Core.
+
+## Cosa include
+- Demo Streamlit locale (`app_showcase.py`)
+- Mini corpus dimostrativo (`demo_corpus.json`)
+- Documentazione tecnica essenziale
+- Policy non-commerciale
+
+## Cosa NON include (intenzionalmente)
+- Corpus proprietario completo
+- Indice FAISS di produzione
+- Pipeline interna completa di ingestione/release enterprise
+- Know-how operativo riservato
+
+In altre parole: questa vetrina mostra il paradigma e l'esperienza d'uso, ma non espone il nucleo IP privato.
+
+## Posizionamento
+AIO non e solo un "RAG dataset": e un knowledge engine locale con memoria, retrieval ibrido e governance.
+
+Questa versione pubblica e una demo controllata per:
+- valutazione tecnica iniziale,
+- test UX/flow,
+- comunicazione pubblica del paradigma.
+
+## Avvio rapido
+```bash
+pip install -r requirements.txt
+streamlit run app_showcase.py
+```
+
+## Licenza
+- Libera per uso e studio
+- Uso commerciale non consentito senza autorizzazione scritta
+- Contatto commerciale: info@rthitalia.com
+
+## DOI di riferimento AIO
+https://doi.org/10.6084/m9.figshare.31384528
+

app_showcase.py

@@ -0,0 +1,172 @@
+import hashlib
+import json
+import re
+from pathlib import Path
+from typing import Dict, List
+
+import numpy as np
+import streamlit as st
+
+try:
+    from sentence_transformers import SentenceTransformer
+except Exception:  # pragma: no cover
+    SentenceTransformer = None
+
+
+STOPWORDS = {
+    "della",
+    "delle",
+    "dello",
+    "degli",
+    "dati",
+    "sono",
+    "come",
+    "questa",
+    "questo",
+    "nella",
+    "nelle",
+    "anche",
+    "molto",
+    "dove",
+    "quando",
+    "with",
+    "that",
+    "from",
+    "have",
+    "your",
+    "will",
+    "about",
+    "parlami",
+    "dimmi",
+    "spiegami",
+    "cosa",
+    "quale",
+}
+
+
+def normalizza_testo(t: str) -> str:
+    t = (t or "").replace("\n", " ").replace("\t", " ").strip()
+    t = re.sub(r"\s+", " ", t)
+    return t
+
+
+def tokenizza(testo: str) -> List[str]:
+    candidati = re.findall(r"[A-Za-z0-9_]+", testo.lower())
+    return [t for t in candidati if len(t) >= 4 and t not in STOPWORDS]
+
+
+class LocalHashEmbedder:
+    def __init__(self, dim: int = 384):
+        self.dim = int(dim)
+        self.name = f"local-hash-{self.dim}"
+
+    def _tokens(self, text: str) -> List[str]:
+        candidati = re.findall(r"[A-Za-z0-9_]+", text.lower())
+        return [t for t in candidati if len(t) >= 3 and t not in STOPWORDS]
+
+    def encode(self, texts):
+        if isinstance(texts, str):
+            texts = [texts]
+        out = np.zeros((len(texts), self.dim), dtype="float32")
+        for i, text in enumerate(texts):
+            clean = normalizza_testo(text)
+            toks = self._tokens(clean) or clean.lower().split()
+            for tok in toks:
+                h = int(hashlib.sha1(tok.encode("utf-8", errors="ignore")).hexdigest(), 16)
+                idx = h % self.dim
+                sign = -1.0 if ((h >> 8) & 1) else 1.0
+                out[i, idx] += sign
+            norm = float(np.linalg.norm(out[i]))
+            if norm > 0:
+                out[i] /= norm
+        return out
+
+
+def inizializza_embedder():
+    model_name = "paraphrase-multilingual-MiniLM-L12-v2"
+    local_path = Path("aio_models") / model_name
+    if SentenceTransformer is not None and local_path.exists():
+        try:
+            model = SentenceTransformer(str(local_path), local_files_only=True)
+            return model, f"sentence-transformers(local-path): {local_path}"
+        except Exception:
+            pass
+    return LocalHashEmbedder(dim=384), "local-hash-embedder (showcase fallback)"
+
+
+def vectorizza(model, testi: List[str]) -> np.ndarray:
+    v = model.encode(testi)
+    arr = np.array(v, dtype="float32")
+    norms = np.linalg.norm(arr, axis=1, keepdims=True)
+    norms[norms == 0] = 1.0
+    arr = arr / norms
+    return arr
+
+
+@st.cache_data
+def carica_corpus() -> List[Dict[str, str]]:
+    path = Path("demo_corpus.json")
+    data = json.loads(path.read_text(encoding="utf-8"))
+    for r in data:
+        r["text"] = normalizza_testo(r.get("text", ""))
+    return data
+
+
+@st.cache_resource
+def prepara_engine():
+    model, backend = inizializza_embedder()
+    records = carica_corpus()
+    texts = [r["text"] for r in records]
+    mat = vectorizza(model, texts)
+    return model, backend, records, mat
+
+
+def cerca(query: str, model, records, mat: np.ndarray, top_k: int = 5):
+    qv = vectorizza(model, [query])[0]
+    sims = mat @ qv
+    qtok = set(tokenizza(query))
+    out = []
+    for i, s in enumerate(sims):
+        rec = records[i]
+        ttok = set(tokenizza(rec["text"]))
+        overlap = len(qtok.intersection(ttok)) if qtok else 0
+        lex = (overlap / max(1, len(qtok))) if qtok else 0.0
+        score = 0.6 * float(s) + 0.4 * float(lex)
+        out.append(
+            {
+                "score": score,
+                "sim": float(s),
+                "lex": float(lex),
+                "domain": rec.get("domain", "generale"),
+                "source": rec.get("source", "showcase"),
+                "text": rec.get("text", ""),
+            }
+        )
+    out.sort(key=lambda x: x["score"], reverse=True)
+    return out[:top_k]
+
+
+st.set_page_config(page_title="AIO Showcase", page_icon=":books:", layout="centered")
+st.title("AIO System Core - Public Showcase")
+st.caption("Demo pubblica controllata. Core proprietario e corpus completo restano privati.")
+
+model, backend, records, mat = prepara_engine()
+st.caption(f"Backend: {backend}")
+st.caption(f"Records demo: {len(records)}")
+
+query = st.text_input("Inserisci una domanda", value="Parlami del Mediterraneo e della geopolitica energetica")
+top_k = st.slider("Top K", min_value=3, max_value=10, value=5, step=1)
+
+if st.button("Esegui ricerca"):
+    risultati = cerca(query, model, records, mat, top_k=top_k)
+    st.subheader("Risultati")
+    for i, r in enumerate(risultati, start=1):
+        st.markdown(
+            f"**{i}. [{r['domain']}]** score={r['score']:.3f} sim={r['sim']:.3f} lex={r['lex']:.3f}"
+        )
+        st.caption(f"source: {r['source']}")
+        st.write(r["text"])
+
+st.markdown("---")
+st.markdown("**Licenza Showcase:** uso e studio liberi, uso commerciale solo su autorizzazione scritta.")
+st.markdown("Contatto: `info@rthitalia.com`")

demo_corpus.json

@@ -0,0 +1,112 @@
+[
+  {
+    "domain": "biologia",
+    "source": "showcase:bio_01",
+    "text": "La biologia dei sistemi studia reti di regolazione, feedback e adattamento in organismi complessi."
+  },
+  {
+    "domain": "biologia",
+    "source": "showcase:bio_02",
+    "text": "L'immunita innata e adattativa cooperano per identificare minacce e mantenere omeostasi."
+  },
+  {
+    "domain": "finanza",
+    "source": "showcase:fin_01",
+    "text": "La gestione del rischio richiede limiti di esposizione, stress test e controllo della varianza."
+  },
+  {
+    "domain": "finanza",
+    "source": "showcase:fin_02",
+    "text": "Inflazione, tassi e liquidita influenzano valutazioni, costo del capitale e investimenti."
+  },
+  {
+    "domain": "fisica",
+    "source": "showcase:phy_01",
+    "text": "La termodinamica descrive trasformazioni energetiche, entropia e vincoli di irreversibilita."
+  },
+  {
+    "domain": "fisica",
+    "source": "showcase:phy_02",
+    "text": "In meccanica quantistica, lo stato del sistema evolve secondo dinamiche probabilistiche."
+  },
+  {
+    "domain": "matematica",
+    "source": "showcase:mat_01",
+    "text": "Probabilita e statistica permettono inferenza su dati incompleti e decisioni sotto incertezza."
+  },
+  {
+    "domain": "matematica",
+    "source": "showcase:mat_02",
+    "text": "L'algebra lineare fornisce strutture per ottimizzazione, segnali e modelli numerici."
+  },
+  {
+    "domain": "tecnologia",
+    "source": "showcase:tec_01",
+    "text": "Un sistema robusto combina modularita, osservabilita e automazione dei controlli di qualita."
+  },
+  {
+    "domain": "tecnologia",
+    "source": "showcase:tec_02",
+    "text": "L'architettura software orientata a componenti riduce accoppiamento e facilita evoluzione."
+  },
+  {
+    "domain": "filosofia_psicologia",
+    "source": "showcase:phi_01",
+    "text": "La psicologia cognitiva analizza bias, attenzione e processi decisionali in ambienti complessi."
+  },
+  {
+    "domain": "filosofia_psicologia",
+    "source": "showcase:phi_02",
+    "text": "L'epistemologia valuta affidabilita delle fonti e criteri di validazione della conoscenza."
+  },
+  {
+    "domain": "storia_politica_diritto",
+    "source": "showcase:law_01",
+    "text": "Lo stato di diritto richiede norme applicabili, trasparenza istituzionale e responsabilita."
+  },
+  {
+    "domain": "storia_politica_diritto",
+    "source": "showcase:law_02",
+    "text": "La geopolitica del Mediterraneo dipende da rotte energetiche, sicurezza marittima e diplomazia."
+  },
+  {
+    "domain": "terra_clima",
+    "source": "showcase:cli_01",
+    "text": "Il cambiamento climatico altera regimi idrologici, eventi estremi e vulnerabilita territoriale."
+  },
+  {
+    "domain": "terra_clima",
+    "source": "showcase:cli_02",
+    "text": "L'oceanografia integra dinamica dei fluidi, chimica marina e cicli biogeochimici."
+  },
+  {
+    "domain": "chimica",
+    "source": "showcase:chem_01",
+    "text": "La cinetica chimica studia velocita di reazione e dipendenza da temperatura e concentrazione."
+  },
+  {
+    "domain": "chimica",
+    "source": "showcase:chem_02",
+    "text": "Catalisi ed elettrochimica sono centrali in accumulo energetico e processi industriali."
+  },
+  {
+    "domain": "mediterraneo",
+    "source": "showcase:med_01",
+    "text": "Il Mediterraneo connette Europa, Africa e Asia attraverso corridoi logistici e culturali."
+  },
+  {
+    "domain": "mediterraneo",
+    "source": "showcase:med_02",
+    "text": "Canale di Suez e Stretto di Gibilterra sono nodi strategici della mobilita globale."
+  },
+  {
+    "domain": "cucina",
+    "source": "showcase:food_01",
+    "text": "Le tecniche di cottura modificano struttura molecolare, sapore e digeribilita degli alimenti."
+  },
+  {
+    "domain": "cucina",
+    "source": "showcase:food_02",
+    "text": "La dieta mediterranea integra nutrizione, stagionalita e sostenibilita culturale."
+  }
+]

requirements.txt

@@ -0,0 +1,3 @@
+streamlit>=1.42
+numpy>=1.26
+sentence-transformers>=3.0