Developers

Build on
Continuis.

The complete toolkit for gateway developers, sensor manufacturers, systems integrators, and anyone building on the Vigil platform — from Python SDKs to CLI tools to the PDP developer programme.

Quickstart Guide → API Reference
Quickstart

Zero to streaming
in five minutes.

Run the node simulator, point it at a local Vigil instance, and watch live measurements appear in your dashboard — no hardware required.

# 1. Start the Vigil stack (Docker required) git clone https://github.com/continuislabs/vigil cd vigil && docker compose up -d # 2. Install the node simulator pip install mnemos-node-simulator # 3. Run a simulated temperature + CO₂ node node-sim \ --hardware-id "AA:BB:CC:DD:EE:FF" \ --quantity temperature \ --quantity co2 \ --rate 1.0 \ --model sinusoidal # Measurements now streaming to http://localhost:8000 # Open Vigil dashboard → your device appears automatically
Software Packages

Every tool
you need.

MNEMOS Gateway
pip install mnemos-gateway

High-performance async MQTT ingestion service that decodes MBP frames from physical nodes and uploads authenticated measurement batches to the Vigil platform. Includes offline SQLite buffering, auto-reconnect, PDP join handling, and Prometheus metrics.

Python 3.10+ aiomqtt httpx aiosqlite asyncio
TEDS Writer
pip install mnemos-teds-writer

Manufacturing CLI for writing and verifying TEDS EEPROM images to probe hardware. Supports all four standard probe types out of the box (PT100, NDIR CO₂, MEMS vibration, gauge pressure), and custom YAML-defined schemas. Includes CRC-32 validation, dry-run mode, and Rich terminal output.

Click CLI smbus2 Rich AT24C16 CRC-32
Node Simulator
pip install mnemos-node-simulator

Synthetic MNEMOS node that publishes valid MBP frames over MQTT — indistinguishable from real hardware at the gateway layer. Supports sinusoidal, random-walk, step, and constant sensor models across all 27 platform quantity types. Essential for CI/CD and pre-hardware platform testing.

Click CLI aiomqtt 27 quantities 4 models
Field App
pip install mnemos-field-app

Progressive Web App for field technicians. Scans device QR codes via phone camera, loads manufacturing and QC data, displays probe-specific video tutorials, runs full PDP pipeline diagnostics, and captures GPS + photo for device provisioning records — works offline.

FastAPI Starlette PWA jsQR GPS EXIF
TEDS Writer CLI

Write. Verify. Ship.

The TEDS writer handles the full manufacturing workflow — from defining a probe schema to burning and verifying the EEPROM in production.

# Write a PT100 temperature probe at I²C address 0x50 teds-write \ --port /dev/i2c-1 \ --probe-type temperature_pt100 \ --serial SN-2025-001 \ --channel-count 2 # Verify what was written back teds-read --port /dev/i2c-1 # Output: ┌─ TEDS EEPROM Contents ──────────────────────────────┐ │ Probe: PT100 Temperature Sensor │ │ Model: MNEMOS-T100 │ │ Serial: SN-2025-001 │ │ Written: 2025-04-13 14:22:07 UTC │ │ Channels: 2 (temperature_celsius, temperature_raw) │ │ CRC-32: 0x4A3B1C2D ✓ │ │ Signature: VALID (Continuis Labs CA) │ └─────────────────────────────────────────────────────┘ # Custom probe type via YAML teds-write --port /dev/i2c-1 --probe-yaml ./my_probe.yaml
Platform API

REST API v1.
Fully documented.

Every Vigil capability is accessible via REST API. Authenticate with a Bearer token, and you have programmatic access to every device, measurement, alert, and dashboard.

Method + PathDescriptionAuth
POST/api/v1/ingest/Ingest a measurement batch from a gatewayGateway Token
POST/api/v1/pdp/gateway/join/Register a gateway and receive routing configGateway Token
POST/api/v1/pdp/probe/Register a probe and receive binding IDsGateway Token
GET/api/v1/devices/List all devices in your organisationUser Token
GET/api/v1/devices/{id}/Get device details and active bindingsUser Token
PATCH/api/v1/devices/{id}/Update device name, site, and metadataOperator
GET/api/v1/measurements/Query time-series measurements with filtersUser Token
GET/api/v1/alerts/rules/List alert rules for your organisationUser Token
POST/api/v1/alerts/rules/Create a new alert threshold ruleOperator
GET/api/v1/alerts/events/List alert events with status/device filtersUser Token
GET/api/v1/pdp/types/Browse public peripheral type registryPublic
POST/api/v1/pdp/types/Publish a new peripheral type (Developer Programme)Developer
POST/api/v1/ai/nlq/Natural language query over measurement historyUser Token
GET/api/v1/reporting/snapshots/List dashboard snapshot reportsUser Token
# Authenticate and ingest measurements curl -X POST https://api.vigil.io/api/v1/ingest/ \ -H "Authorization: Bearer gw_..." \ -H "Content-Type: application/json" \ -d '{ "gateway_id": "gw-001", "hardware_id": "AA:BB:CC:DD:EE:FF", "measurements": [ { "binding_id": "b_3f9a2", "timestamp": "2025-04-13T14:00:00Z", "value": 23.4, "quality": 192 } ] }' # Response { "accepted": 1, "rejected": 0, "stored_at": "2025-04-13T14:00:00.142Z" }
View Full API Reference →
PDP Developer Programme

Build a probe.
Reach every Vigil customer.

Register as a Continuis developer, define your probe's TEDS schema and PDP peripheral type, and your sensor appears in the Vigil marketplace available to every customer worldwide.

How It Works

Four steps from probe design to platform listing.

1
Register
Create a developer profile on the Vigil platform. Free for hardware manufacturers and research groups.
2
Define Schema
Submit your TEDS EEPROM layout and peripheral type definition via REST API or the TEDS Writer CLI.
3
Review
Continuis engineering reviews your peripheral type for protocol compliance and security. Usually 2–5 business days.
4
Publish
Your probe type goes live in the Vigil peripheral registry. Every customer with a matching probe sees it auto-identified on connection.
Get Building

Ready to build
on Continuis?

Request developer access, get your API credentials, and spin up your first simulated device in minutes.

Request Dev Access → Protocol Specification