How jorgedsprojects/inari works
INARI connects plant equipment to an ISA-95 namespace, archives raw MQTT traffic, normalizes it into versioned silver data, and exposes that data through dashboards and a tool-limited natural-language assistant. The graph preserves the documented bronze-to-silver flow and the separate dashboard and copilot branches. Source excerpts show selected service wiring; README statements support the cross-service links and unsampled capabilities, so those links are cited as documented rather than as inspected implementation.
Main entry points: app/main.py Raw MQTT ingestor · batch.py Batch transformation · app/main.py Dashboard API · db.py Bronze history
Components 29
Namespace management
- Namespace panel
UNS_MANAGER/frontend/src/App.tsx - Hierarchy and broker API
UNS_MANAGER/backend/app/main.py - ISA-95 namespace model
UNS_MANAGER/backend/app/models/uns.py - MQTT publishing
UNS_MANAGER/backend/app/services/mqtt_service.py
Industrial data pipeline
- Raw MQTT ingestor
UNS_HISTORIAN/ingestor/app/main.py - Message handling
UNS_HISTORIAN/ingestor/app/handler.py - Deduplication and buffer
UNS_HISTORIAN/ingestor/app/dedup.py - Bronze history
UNS_HISTORIAN/ingestor/app/db.py - Silver normalizer
UNS_SILVER/normalizer/app/main.py - Batch transformation
UNS_SILVER/normalizer/app/batch.py - Versioned signal catalog
UNS_SILVER/normalizer/app/catalog.py - Typed readings and events
UNS_SILVER/normalizer/app/db.py
Natural-language assistant
- Copilot chat API
UNS_COPILOT/backend/app/routers/chat.py - Tool-calling agent
UNS_COPILOT/backend/app/agent/loop.py - Read-only data tools
UNS_COPILOT/backend/app/tools/executor.py - Conversation history
UNS_COPILOT/backend/app/models/chat.py
Dashboards
- Dashboard editor and viewer
UNS_DASHBOARD/frontend/src/App.tsx - Dashboard API client
UNS_DASHBOARD/frontend/src/api/client.ts - Dashboard API
UNS_DASHBOARD/backend/app/main.py - Dashboard and chart data
UNS_DASHBOARD/backend/app/models/dashboard.py - Dashboard database
UNS_DASHBOARD/backend/app/database.py - Historical historian queries
UNS_DASHBOARD/backend/app/services/historian_query.py - MQTT-to-Redis bridge
UNS_DASHBOARD/bridge/app/main.py - Live dashboard stream
UNS_DASHBOARD/backend/app/routers/stream.py
Other components
- Sensors and PLCs
- MQTT broker
- Plant user
- OpenAI-compatible LLM
- Live-data cache
Connections 31
- Sensors and PLCs → MQTT broker: publish readings
README.md - Namespace panel → Hierarchy and broker API: manage namespace
README.md - Hierarchy and broker API → ISA-95 namespace model: models hierarchy
- Hierarchy and broker API → MQTT publishing: configures MQTT
UNS_MANAGER/backend/app/main.py - MQTT publishing → MQTT broker: publishes metadata
UNS_MANAGER/backend/app/services/mqtt_service.py - MQTT broker → Raw MQTT ingestor: delivers raw messages
README.md - Raw MQTT ingestor → Message handling: handles messages
UNS_HISTORIAN/ingestor/app/main.py - Raw MQTT ingestor → Deduplication and buffer: deduplicates and buffers
UNS_HISTORIAN/ingestor/app/main.py - Raw MQTT ingestor → Bronze history: writes batches
UNS_HISTORIAN/ingestor/app/main.py - Bronze history → Silver normalizer: bronze input
README.md - Silver normalizer → Batch transformation: processes batches
UNS_SILVER/normalizer/app/main.py - Silver normalizer → Typed readings and events: applies retention
UNS_SILVER/normalizer/app/main.py - Batch transformation → Bronze history: reads bronze rows
README.md - Batch transformation → Versioned signal catalog: normalizes catalog
- Batch transformation → Typed readings and events: writes typed data
README.md - Plant user → Copilot chat API: asks plant questions
README.md - Copilot chat API → Tool-calling agent: runs chat workflow
README.md - Tool-calling agent → OpenAI-compatible LLM: requests completion
README.md - Tool-calling agent → Read-only data tools: dispatches tools
README.md - Read-only data tools → Typed readings and events: queries silver data
README.md - Copilot chat API → Conversation history: stores conversations
README.md - Plant user → Dashboard editor and viewer: creates and views dashboards
README.md - Dashboard editor and viewer → Dashboard API client: requests dashboard data
UNS_DASHBOARD/frontend/src/App.tsx - Dashboard API client → Dashboard API: calls REST endpoints
UNS_DASHBOARD/frontend/src/api/client.ts - Dashboard API → Dashboard and chart data: serves dashboard CRUD
UNS_DASHBOARD/backend/app/main.py - Dashboard API → Dashboard database: persists dashboards
UNS_DASHBOARD/backend/app/main.py - Dashboard API → Historical historian queries: serves history queries
README.md - Historical historian queries → Bronze history: reads historian data
README.md - MQTT broker → MQTT-to-Redis bridge: streams MQTT data
README.md - MQTT-to-Redis bridge → Live-data cache: writes live data
UNS_DASHBOARD/bridge/app/main.py - Live dashboard stream → Live-data cache: serves live data
README.md