No description
  • Python 74.9%
  • JavaScript 9.5%
  • Shell 7.9%
  • CSS 4.6%
  • C++ 2%
  • Other 1.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
jonnibongallino b7e8228b81 Rinomina completa bra -> nabu (scelta A): solo Nabu il portinaio
- id funzionali: bra-node -> nabu-node, bra_node_* -> nabu_node_*, bra_portinaio -> nabu_portinaio
- env vars BRA_* -> NABU_*, venv bra-hub-venv -> nabu-hub-venv
- file rinominati: firmware/esphome/nabu-*.yaml, componente HA custom_components/nabu_portinaio/, plist it.nabu.*
- rimossa la cronaca di sviluppo della prima fase: docs/storia/ (NODO-MUTO, NODO-OFFLINE, PIANO-ORCA, REPORT-PORTINAIO)
- residui in prosa (Corina, namespace MQTT bra/) verranno ripuliti nella riscrittura dei doc

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-10-13 16:32:21 +02:00
content Riordino identità: BRA Smart Eyes -> Nabu, slug -> nabu-portinaio; README col filo BRCA 2026-10-07 12:44:15 +02:00
docs Rinomina completa bra -> nabu (scelta A): solo Nabu il portinaio 2026-10-13 16:32:21 +02:00
firmware Rinomina completa bra -> nabu (scelta A): solo Nabu il portinaio 2026-10-13 16:32:21 +02:00
hardware/enclosure Repo replicabile: guida COME-ABBIAMO-FATTO, modello 3D enclosure, README sintetico, riordino doc 2026-10-07 17:44:30 +02:00
hub Rinomina completa bra -> nabu (scelta A): solo Nabu il portinaio 2026-10-13 16:32:21 +02:00
tools Rinomina completa bra -> nabu (scelta A): solo Nabu il portinaio 2026-10-13 16:32:21 +02:00
.gitignore Prep repo pubblicabile: schemi SVG, suono cerco-rete, eventi hub, script cambio-rete; blindo .gitignore contro i .bak 2026-10-07 12:31:39 +02:00
CLAUDE.md Riordino identità: BRA Smart Eyes -> Nabu, slug -> nabu-portinaio; README col filo BRCA 2026-10-07 12:44:15 +02:00
README.md Rinomina completa bra -> nabu (scelta A): solo Nabu il portinaio 2026-10-13 16:32:21 +02:00

Nabu — il portinaio smart della Casa di Quartiere

Nabu

Da BRCA, Brindisi Città Aperta. Durante l'evento un gruppo di ricerca ha intrecciato design, tecnologia e processi attorno a una domanda semplice: come può una Casa di Quartiere accogliere chi entra? L'output è Nabu — il portinaio smart, l'assistente vocale della Casa di Quartiere.

Nabu sta sulla soglia. Quando arrivi, l'anello di luce reagisce («ti ho visto»), una voce ti accoglie al genere neutro, e a voce («Okay Nabu, …») risponde e comanda i dispositivi della Casa. Tutto in rete locale, non presidiato, non sorveglianza.

Cosa fa

  • Accoglie chi entra con una voce neutra (content/messaggi.yaml).
  • Riconosce e conta gli ingressi — solo impronte numeriche, mai foto (docs/PRIVACY.md).
  • Risponde e comanda a voce: «Okay Nabu, accendi la luce della stampante», «a che punto è la stampa?», «parlami delle Case di Quartiere».
  • Notifica su un bot Telegram.

Il filo

  • L'evento — BRCA, Brindisi Città Aperta: immaginare servizi di prossimità, aperti, per la città.
  • Il gruppo di ricerca — ha unito design, tecnologia e processi per progettare e costruire il dispositivo.
  • L'output — Nabu, il portinaio smart: la soglia che accoglie, riconosce, orienta e dà voce alla Casa.

Tutto open source: il codice è aperto, ispezionabile, riusabile. Nabu può diventare un ecosistema di portinai, uno per ogni Casa.

Replicarlo da zero

Guida unica, passo-passo (materiali → montaggio → ESP → Home Assistant → Ollama → test): docs/COME-ABBIAMO-FATTO.md.

Schemi: collegamento realistico · montaggio · architettura · pinout e cablaggio in docs/WIRING.md.

Hardware (sintesi)

Pezzo Componente
Cervello del nodo Goouuu ESP32-S3-CAM (8MB PSRAM, camera OV2640 a bordo)
Microfono INMP441 (I2S)
Voce MAX98357A (ampli I2S) + altoparlante — oppure DAC PCM5102/PCM5122 verso casse attive
Sguardo anello NeoPixel WS2812B
Comando pulsante (tap-to-talk) + wake word «Okay Nabu»
Cervello della Casa un PC/Mac sempre acceso con Home Assistant + Ollama

Dettagli e fonti dei pin: docs/HARDWARE-NOTES.md.

Struttura del repo

docs/        guide e riferimenti (COME-ABBIAMO-FATTO, HARDWARE-NOTES, WIRING, PRIVACY, …) · img/ · storia/ (cronaca di sviluppo)
firmware/    esphome/nabu-node.yaml (il nodo) · sounds/ · src/ (sketch di bring-up)
hub/         portinaio/ (l'hub: config, stato, eventi, tool) · dashboard/ · nabu_eye.py (l'occhio: camera → Telegram) · homeassistant/
content/     messaggi.yaml (frasi vocali, al neutro)
tools/       setup, flash del nodo, esposizione entità ad Assist

Regole del progetto

  • Linguaggio neutro in ogni testo rivolto a chi entra (voce, dashboard, Telegram) — mai maschile/femminile, mai schwa/asterischi (il sintetizzatore non li pronuncia). Dettagli in CLAUDE.md.
  • Niente pin inventati: ogni GPIO cita la sua fonte.
  • Privacy: solo embedding non reversibili, tutto in LAN, nessuna foto salvata (docs/PRIVACY.md).
  • Nessun segreto nel repo: Wi-Fi, token e chiavi stanno in file *.example da compilare in locale.

Licenza

Da definire prima della pubblicazione (il progetto nasce open source).