infinimesh is a opinionated multi-tenant hyperscale Internet of Things platform to connect IoT devices fast and securely with minimal TCO. It features a unique Graph-based authorization system, allowing users & engineers to create arbitrary hierarchical ontologies, with the possibility to scope permissions down to single sub-devices to specific users (e.g. suppliers). It exposes simple to consume RESTful & gRPC APIs with both high-level (e.g. device shadow) and low-level (sending messages) concepts. The infinimesh IoT platform is open source and fully kubernetes compliant. No vendor lock-in - run it yourself on Kubernetes in your own datacenter, under your control with maximum data privacy.

Our API's (REST / gRPC / ConnectRPC) are considered as beta and may change in future. infinimesh has already available:

• MQTT support for version 3 and 5
• State management (digital twin)
• Graph-based permission management (multi-dimensional permissons at data layer)
• TLS 1.2 / 1.3 support
• Device-to-Cloud and Cloud-to-Device messages
• Enhanced UI
• k8s and Docker environments

Check out our:

• Wiki here.
• Swagger UI soon to be deprecated

You can reach out to the community via Discord.

The recommended way to interact with infinimesh API is gRPC and ConnectRPC. Thus, we provide protobuf files at infinimesh/proto, using which you can generate a client library for your programming language of choice.

Additionally, we have pregenerated libraries:

Can be added to your project via:

go get github.com/infinimesh/proto@latest

Can be obtained from npm via:

npm install infinimesh-proto

Has to be downloaded from infinimesh/proto, you can copy the whole build/dart dir into your Flutter project

Start with inf help and inf help login ;)

See macOS.

Just run

snap install inf

and see usage usage

1. Go to CLI Releases
2. Get .deb package for your CPU arch (arm64 or x86_64)
3. dpkg -i path/to/.deb

If you're using some other arch, let us know, we'll add it to the build. Meanwhile - try building from source

Then see usage usage

1. Go to CLI Releases
2. Get .rpm package for your CPU arch (arm64 or x86_64)
3. yum localinstall path/to/.rpm or dnf install path/to/.rpm

If you're using some other arch, let us know, we'll add it to the build. Meanwhile - try building from source

Then see usage usage

If you have yaourt or yay package must be found automatically by label inf-bin

Otherwise,

1. git clone https://aur.archlinux.org/packages/inf-bin
2. cd inf-bin
3. makepkg -i

Then see usage usage

If you're using other package manager or have none, you can download prebuilt binary in .tar.gz archive for arm64 or x86_64, unpack it and put inf binary to /usr/bin or your $PATH/bin.

If you're using some other arch, let us know, we'll add it to the build. Meanwhile - try building from source

Then see usage usage

If you're using Homebrew:

brew tap infinimesh/inf
brew install inf

You're good to go!

Then see usage usage

If you don't have Homebrew, consider using it ;), otherwise you can get prebuilt binary from CLI Releases page as an .tar.gz archive.

# if you have wget then
wget https://github/infinimesh/inf/releases/#version/inf-version-darwin-arch.tar.gz
# if you don't, just download it
tar -xvzf #inf-version-darwin-arch.tar.gz
# move binary to /usr/local/bin or alike
mv #inf-version-darwin-arch/inf /usr/local/bin

You're good to go!

Then see usage usage

1. Go to CLI Releases
2. Get prebuilt binary from CLI Releases page as an .zip archive.
3. Unpack it
4. Put it somewhere in $PATH

Then see usage usage

See CLI repo for source and instructions.

We have built an automated local development setup based on Docker.

1. Add this entries to /etc/hosts:

127.0.0.1 api.infinimesh.local 
127.0.0.1 console.infinimesh.local
127.0.0.1 traefik.infinimesh.local
127.0.0.1 rbmq.infinimesh.local
127.0.0.1 db.infinimesh.local
127.0.0.1 media.infinimesh.local
127.0.0.1 mqtt.infinimesh.local

2. Clone this repo via git clone https://github.com/infinimesh/infinimesh.git
3. cd into the fresh cloned repo
4. Run docker compose up

Swagger API: https://infinimesh.github.io/infinimesh/

Clone proto repo

Navigate to cloned repo directory and run:

docker run -it \
  -v $(pwd):/go/src/github.com/infinimesh/proto \
  ghcr.io/infinimesh/proto/buf:latest

Right now we keep protos generated only for Go. If you need one of the other languages, add according module to buf.gen.yaml.

PRs are as always welcome.

infinimesh is using mockery. To generate mocks it is recommended to use Docker image:

docker pull vektra/mockery
docker run -v "$PWD":/src -w /src vektra/mockery --all

Otherwise just get the mockery binary and run it at the root of the project.

Start the local dev environment via docker compose up -d.

Login locally via CLI:

inf login api.infinimesh.local infinimesh infinimesh --insecure

Access the Console at http://console.infinimesh.local

Copyright 2018 - 2024 the infinimesh committers, 2pk03, birdayz, slntopp and The Infinite AI Audio GmbH team

Licensed under the Apache License, Version 2.0 (the "Licenses"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

https://github.com/infinimesh/infinimesh/blob/master/LICENSE

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

The authors of infinimesh are The Infinite AI Audio GmbH, birdayz, 2pk03 and slntopp, all rights reserved.