Libertas Studio
Libertas Studio is a Visual Studio Code extension designed for building, testing, deploying, and managing agentic applications on the Libertas Platform. It provides visual editors, autocomplete providers, and environment setup tools to make IoT and multi-agent development seamless and highly performant.
Key Features
💻 Smart Intellisense & Decorators
- Direct auto-completion support for all Libertas decorators (e.g.,
@LibertasExport, @LibertasDeviceType, @LibertasVirtualDeviceType).
- Syntax highlighting and inline documentation hints for Libertas schemas.
🛠️ Prerequisites & Automatic SDK Installer
- Automatic prerequisite checker verifying essential tools: Node.js, Cargo & Rust toolchain, Zig Compiler, cargo-zigbuild, Rust target toolchains, and the Libertas Platform SDK.
- Streamlined interactive installation helper to ready your workspace environment automatically.
🎨 Premium Visual Editors
- Admin Panel: Comprehensive visual dashboard to manage Hub security (Users, Groups, Access Control Lists (ACLs), privileges), LLM connectors, and task scripts. Includes smart Unique Constraint handling that dynamically recalculates and filters dropdown options to prevent duplicates.
- Control Panel: Live Control Board interface showcasing real-time device states, parameters, and allowing developers to trigger actions directly.
- Monitor View: Observe real-time log messages and protocol traffic with a slide-out drawer inspector. All overlays and drawers feature high-performance GPU hardware acceleration and smooth 60fps animations.
- Libertas Machine Designer: An interactive graph-based workspace canvas to visualize, connect, and configure hub state machines, functions, parameters, and pin bindings.
- Device & Virtual Device Type Editors: Visual catalog tool to configure hardware-specific Matter device configurations and simulated virtual devices.
Prerequisites
To build and deploy apps with the Libertas SDK, your local environment needs:
- Node.js & Cargo/Rust (pre-installed).
- Pipx (optional, used for compiler tool installations).
Contributed Commands
Access these commands from the VS Code Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
| Command ID |
Title |
Purpose |
libertas.createNewProject |
Libertas: Create New Project |
Initializes a new agent or hub application structure. |
libertas.manageHubs |
Libertas: Manage Hubs |
Opens the visual dashboard to manage Libertas Hubs. |
libertas.deploy |
Libertas: Deploy to a Hub |
Compiles (using cargo-zigbuild) and deploys to target hubs. |
libertas.monitor |
Libertas: Monitor Hub |
Streams log files and events from the connected hub. |
libertas.openSchemaEditor |
Libertas: Edit Schema |
Opens the visual schema custom editor. |
libertas.openAdminPanel |
Libertas: Open Admin Panel |
Opens the visual dashboard to configure security settings, users, groups, tasks, and scripts. |
libertas.openControlPanel |
Libertas: Open Control Panel |
Opens the visual control dashboard for real-time live device commands. |
libertas.openMachineDesigner |
Libertas: Machine Designer |
Visual workspace to design and configure hub state machines. |
libertas.openDeviceTypeEditor |
Libertas: Device Type Editor |
Visual catalog of custom device type properties. |
libertas.openVirtualDeviceTypeEditor |
Libertas: Virtual Device Type Editor |
Visual editor to configure simulated virtual devices. |
Getting Started
- Open a workspace folder containing a Libertas project.
- The extension will automatically verify prerequisites and display an installation dashboard if any are missing.
- If dependencies are missing, follow the interactive setup instructions to install the Libertas Platform SDK and the Zig Compiler.
- Start writing agents in TypeScript/JavaScript or Rust and use the visual commands to design, configure, and deploy!
| |
