Skip to main content

Mesh Foundation Quick Start

The mesh-foundation addon is pre-installed with mimOE. This guide walks you through verifying it and running your first node discovery.

Prerequisites​

  • mimOE runtime running on your device (Install guide)
  • Two or more mimOE nodes on the same local network (for link-local discovery)
info

The mesh-foundation addon is included in the standard mimOE installation alongside the ai-foundation addon. No separate install step is needed.

Step 1: Verify the Addon Is Running​

Query your own node info to confirm the Insight mim is active:

curl -X GET "http://localhost:8083/mimik-mesh/insight/v1/info?types=self" \
  -H "Authorization: Bearer 1234"

You should see a response with your node's identity:

{
  "data": {
    "self": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "My Device",
      "os": "darwin",
      "addresses": [
        {
          "type": "local",
          "url": { "href": "http://192.168.1.100:8083" }
        }
      ],
      "services": []
    }
  }
}

Step 2: Discover Nodes on Your Network​

With another mimOE node on the same network, run link-local discovery:

curl -X GET "http://localhost:8083/mimik-mesh/insight/v1/nodes?type=linkLocal" \
  -H "Authorization: Bearer 1234"

The response lists all mimOE nodes discovered on your local network:

{
  "data": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Living Room Hub",
      "os": "linux",
      "addresses": [
        {
          "type": "local",
          "url": { "href": "http://192.168.1.101:8083" }
        }
      ],
      "services": []
    }
  ]
}

What Just Happened?​

  1. The mesh-foundation addon was already deployed with your mimOE installation, including the Insight mim
  2. The Insight mim joined the link-local mesh on your network automatically
  3. You queried your own node identity via the /info endpoint
  4. You discovered other mimOE nodes on the same network via the /nodes endpoint

All of this happened on your local network with no cloud services involved.

What's Next: AI Mesh​

Now that you can discover nodes, try combining both foundations. Discover a remote node and run inference on it without a local model:

AI Mesh Example: Two curl commands, two nodes, zero cloud.

Next Steps​