- Python 74.9%
- JavaScript 9.5%
- Shell 7.9%
- CSS 4.6%
- C++ 2%
- Other 1.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- 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]> |
||
| content | ||
| docs | ||
| firmware | ||
| hardware/enclosure | ||
| hub | ||
| tools | ||
| .gitignore | ||
| CLAUDE.md | ||
| README.md | ||
Nabu — il portinaio smart della Casa di Quartiere
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
*.exampleda compilare in locale.
Licenza
Da definire prima della pubblicazione (il progetto nasce open source).
