feat: BUSL license + Gemini plugin + pricing + PyPI workflow

Author: Christian Quintino De Luca

.github/workflows/publish-core.yml

@@ -0,0 +1,59 @@
+name: Publish Core (TestPyPI/PyPI)
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - 'aspera-v*'
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Build
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish-testpypi:
+    needs: build
+    if: ${{ github.event_name == 'workflow_dispatch' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@v1.9.0
+        with:
+          print-hash: true
+          repository-url: https://test.pypi.org/legacy/
+          user: __token__
+          password: ${{ secrets.TEST_PYPI_API_TOKEN }}
+
+  publish-pypi:
+    needs: build
+    if: startsWith(github.ref, 'refs/tags/aspera-v')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.9.0
+        with:
+          print-hash: true
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+

LICENSE

@@ -1,22 +1,21 @@
-MIT License
+Business Source License 1.1 (BUSL-1.1)
 
-Copyright (c) 2025 Christian Quintino De Luca - RTH Italia
+Licensor: Christian Quintino De Luca - RTH Italia
+Licensed Work: ASPERA (the "Software")
+Additional Use Grant: You may use, copy, modify, and self-host the Software for
+non-production and internal production purposes. You may not provide the
+Software to third parties as a managed service or compete with the Licensor’s
+hosted offerings during the Change Date Period.
 
-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:
+Change Date: 2027-10-08
+Change License: Apache License, Version 2.0
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+License Terms: The Licensor hereby grants you the right to use the Software
+under the Business Source License 1.1, a copy of which is available at
+https://mariadb.com/bsl11/.
 
-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.
+Any use not explicitly granted herein is prohibited. After the Change Date,
+the Software will be made available under the Change License.
 
+Trademarks: This license does not grant you any right in the Licensor’s
+trademarks, service marks, or logos, including "ASPERA".

README.md

@@ -7,7 +7,7 @@
 **Un framework innovativo per sistemi cognitivi che unisce ragionamento simbolico e intelligenza artificiale**
 
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![License](https://img.shields.io/badge/license-BUSL--1.1-blue)](LICENSE)
 [![Tests](https://img.shields.io/badge/tests-37%2F39%20passing-brightgreen)](aspera/tests/)
 [![Groq](https://img.shields.io/badge/LLM-Groq%20Powered-orange)](https://groq.com)
 [![Product Status](https://img.shields.io/badge/status-PRODUCTION%20READY-success)](STARTUP_ROADMAP.md)
@@ -108,6 +108,39 @@ python aspera_cli.py run --aspera aspera/lang/examples/empathetic.aspera --signa
 python aspera_cli.py validate ast.json
 ```
 
+### Plugin: installazione, discovery e uso (incluso Gemini)
+
+```bash
+# Installa plugin esterni (esempi)
+python -m pip install -e plugins/aspera-vector-weaviate
+python -m pip install -e plugins/aspera-llm-openai
+python -m pip install -e plugins/aspera-llm-gemini
+
+# Scopri e lista plugin disponibili
+python aspera_cli.py plugins discover
+python aspera_cli.py plugins list
+```
+
+Uso programmatico con `PluginManager`:
+
+```python
+from aspera.plugins.plugin_interface import PluginManager
+
+pm = PluginManager()
+pm.discover_plugins()
+
+llm = pm.get_plugin("openai_llm") or pm.get_plugin("gemini_llm")
+if llm:
+    llm.initialize({"model": "gpt-4o-mini", "temperature": 0.7})
+    print(llm.generate_inference(context={}, signals={}, rules=["if a then b"]))
+
+vec = pm.get_plugin("weaviate_vector")
+if vec:
+    vec.initialize({"url": "http://localhost:8080", "class_name": "AsperaVector"})
+    vec.save("demo", "hello")
+    print("Loaded:", vec.load("demo"))
+```
+
 ### 🔌 Plugins: installazione rapida
 
 ```bash

docs/PLUGINS.md

@@ -58,6 +58,7 @@ class MyLLM(LLMPlugin):
 
 - `openai_llm` (pacchetto: `aspera-llm-openai`): provider LLM OpenAI.
 - `weaviate_vector` (pacchetto: `aspera-vector-weaviate`): storage vettoriale Weaviate.
+- `gemini_llm` (pacchetto: `aspera-llm-gemini`): provider LLM Google Gemini (tier gratuito).
 
 ### Installazione
 
@@ -67,6 +68,31 @@ python aspera_cli.py plugins discover
 python aspera_cli.py plugins list
 ```
 
+### Pubblicazione su TestPyPI/PyPI
+
+1) Build locale del pacchetto (esempio Weaviate):
+
+```bash
+cd plugins/aspera-vector-weaviate
+python -m pip install --upgrade build
+python -m build
+```
+
+2) Upload su TestPyPI con `twine`:
+
+```bash
+python -m pip install --upgrade twine
+python -m twine upload --repository testpypi dist/*
+```
+
+3) Installazione dal TestPyPI per verifica:
+
+```bash
+python -m pip install --index-url https://test.pypi.org/simple/ --no-deps aspera-vector-weaviate
+```
+
+4) Pubblicazione PyPI: configura token in CI (GitHub Actions) e tagga la release (vedi workflow nei plugin di esempio).
+
 ### Uso programmatico
 
 ```python

docs/PRICING.md

@@ -2,33 +2,30 @@
 
 ## Tiers
 
-### FREE
-- 5s execution time (per observation)
-- 100MB memory cap
-- 1,000 tokens per observation
-- 3 LLM calls per observation
-- 10 observations/min
+### Community (FREE)
+- Uso locale illimitato (open core BSL 1.1)
+- SDK/CLI/LSP, plugin system
+- Usa la tua `GROQ_API_KEY` (tier gratuito Groq)
+- Supporto: GitHub Issues (best‑effort)
 
-### PRO - €49/month
-- 30s execution time
-- 500MB memory cap
-- 10,000 tokens per observation
-- 10 LLM calls per observation
-- 60 observations/min
+### Pro (€99/mese)
+- Cloud hosted da RTH Italia (API managed)
+- SLA 99%, email support (24h)
+- Billing a consumo: token/azioni
+- Dashboard metriche e limiti configurabili
 
-### ENTERPRISE - Custom
-- 120s execution time
-- 2GB memory cap
-- 100,000 tokens per observation
-- 50 LLM calls per observation
-- Unlimited rate (per SLA)
+### Enterprise (Custom)
+- On‑prem / VPC, multi‑region, DR (RTO/RPO)
+- Compliance (SOC2/DPA), audit avanzato
+- Supporto 24/7, SLA 99.9%
+- Agenti verticali e training su dati proprietari
 
 ## ROI Calculator
-**Input**: observations/month  
-**Output**: cost savings vs pure LLM (Groq FREE + symbolic)
+**Input**: osservazioni/mese  
+**Output**: risparmio vs LLM puro (Groq + simbolico)
 
-Example: 100K obs/month
-- Pure LLM: $2,000
-- ASPERA PRO: $49 + $200 = $249
-- **Savings**: 87%
+Esempio: 100K osservazioni/mese
+- LLM puro: $2,000
+- ASPERA Pro: €99 + $200 = ~$299
+- **Risparmio**: ~85%
 

plugins/aspera-llm-gemini/README.md

@@ -0,0 +1,48 @@
+# aspera-llm-gemini
+
+Plugin LLM per ASPERA basato su Google Gemini (tier gratuito disponibile).
+
+## Installazione
+
+```bash
+pip install aspera-llm-gemini
+```
+
+Sviluppo locale:
+```bash
+python -m pip install -e plugins/aspera-llm-gemini
+```
+
+## Configurazione
+
+- `GEMINI_API_KEY` (richiesta)
+- `GEMINI_MODEL` (default: `gemini-1.5-flash`)
+
+## Uso con CLI ASPERA
+
+```bash
+python aspera_cli.py plugins discover
+python aspera_cli.py plugins list   # vedrai gemini_llm
+```
+
+## Uso programmatico
+
+```python
+from aspera.plugins.plugin_interface import PluginManager
+
+pm = PluginManager()
+pm.discover_plugins()
+llm = pm.get_plugin("gemini_llm")
+if llm:
+    llm.initialize({"model": "gemini-1.5-flash"})
+    print(llm.generate_inference(context={}, signals={}, rules=["if a then b"]))
+```
+
+## Build & Publish
+
+```bash
+python -m pip install --upgrade build
+python -m build
+python -m pip install --upgrade twine
+python -m twine upload --repository testpypi dist/*
+```

plugins/aspera-llm-gemini/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aspera-llm-gemini"
+version = "0.1.0"
+description = "ASPERA plugin: Google Gemini LLM provider"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Apache-2.0" }
+authors = [
+  { name = "RTH Italia", email = "info@rthitalia.com" }
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+  "google-generativeai>=0.8.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/rthitalia/aspera"
+Repository = "https://github.com/rthitalia/aspera"
+
+[project.entry-points."aspera.plugins"]
+gemini_llm = "aspera_llm_gemini.plugin:GeminiLLMPlugin"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["aspera_llm_gemini"]
+
+

plugins/aspera-llm-gemini/src/aspera_llm_gemini/__init__.py

@@ -0,0 +1,3 @@
+from .plugin import GeminiLLMPlugin
+
+__all__ = ["GeminiLLMPlugin"]