Tier0 is an open-source industrial data integration platform built on the Unified Namespace (UNS) methodology and powered by production-grade open-source technologies.

• Source Flow
  Serves as the connection pipeline to devices and systems. It handles real-time protocol translation into JSON payloads. Built entirely on Node-RED.

• Namespace
  The core of Tier0. A semantic MQTT broker and parser that models data using topic hierarchies and structured JSON payloads.

• Sink
  The storage layer of Tier0.

  • Time-series Namespace values are stored in TimescaleDB.
  • Relational Namespace values (e.g., CRM data) are stored in PostgreSQL.
    This enables efficient querying and compression.

• Event Flow
  Orchestrates Namespaces into higher-level event/information flows. Supports merging JSON payloads and appending system-generated prompts for LLM-powered optimization.

For detailed guides and advanced examples, see the Tier0 Community Docs.

• Operating System: Currently tested on Ubuntu Server 24.04 with Docker. We welcome feedback on other OS distributions.
• Docker: We assume you have Docker (with docker compose and buildx) installed. Our tested versions:
  • Docker Engine - Community: 27.4.0
  • Docker Buildx: v0.19.2
  • Docker Compose: v2.31.0
  • containerd: 1.7.24

1. Clone the project.

   git clone <this repo>

2. Navigate to the Tier0 directory and edit environment variables in the .env file.

   cd Tier0-Edge
   vi .env

   • Update VOLUMES_PATH (directory for storing project data).
   • Update ENTRANCE_DOMAIN (frontend entry domain/IP address).
   • Modify other variables as needed.
3. Install Tier0.

   bash bin/install.sh

• Install the latest version of Docker Desktop and Git on Windows 10 or Windows 11.
• It is recommended to perform all operations in Git Bash for better compatibility.

1. Clone the project using Git Bash.

   git clone <this repo>

2. Navigate to the Tier0 directory and edit environment variables in the .env file.

   cd Tier0-Edge
   vi .env

   • Update OS_PLATFORM_TYPE = windows
   • Update VOLUMES_PATH (directory for storing project data).
   • Update ENTRANCE_DOMAIN (Do not use 127.0.0.1 or localhost, otherwise login and authentication functions will NOT work.)
   • Modify other variables as required by the system.
3. Install Tier0.

   bash bin/install.sh

1. Visit http://<YOUR-DOMAIN>:<YOUR-PORT> in your browser (based on ENTRANCE_DOMAIN and ENTRANCE_PORT in .env).
2. Sign in to Tier0 with default account and password: supos/supos.

Factory/workshop/equipment/CNC will be used as an example, in which Factory, workshop and equipment are paths and CNC is a topic.

1. Log in to Tier0, and then select UNS > Namespace.
2. Under Topic, click to add a path (e.g. factory).

3. Select equipment, and then click to add a topic (e.g.CNC) under it.

4. Enter the information of the topic, and then click Save.

1. Log in to Tier0, and then select UNS > Namespace.
2. Click Import at the upper-right corner.

3. Import JSON to create models.

• Directly enter JSON.

• Click Upload File to download the template and enter the model content according to template rules.

You can manually add a path and topic, export it and use it as an example for import.

4. Save the template file, and then click Import on the Namespace page.
5. Select the template, and then click Save.

1. Log in to Tier0, and then select UNS > Namespace.
2. Click on the Topic page.

3. Select the data type, and then write JSON text for the model according to the data tree structure.

{
    "Factory1": {
        "workshop1": {
            "equipment1": {
                "CNC1": [
                    {
                        "actualRuntime1": 1380,
                        "plannedRuntime1": 1440
                    }
                ]
            }
        }
    }
}

4. Click Next, and select the model on the left side. :::tip Click on each data level, you can change its information and add attributes on the right side. :::

5. Click Save.

Connect real data to make models alive.

1. Log in to Tier0, go to UNS > Namespace, and under the Topic tab, select a file.
2. Scroll down to Topology, click the icon on Source Flow to redirect to the generated data flow.

3. Change the data source of the generated flow.

4. Deploy and trigger the flow.

This project is licensed under the Apache 2.0 License.

• 📖 Documentation
• 🐞 GitHub Issues

We gratefully acknowledge the following individuals for their contributions to Tier0:

Wenhao Yu, Liebo, Weipeng Dong, Kangxi, Lifang Sun, Minghe Zhuang,
Wangji Xin, Fayue Zheng & Yue Yang, Yanqiu Liu, Dongdong An, Jianan Zhu