README
¶
Vinculum
"The [vinculum is the] processing device at the core of every Borg vessel. It interconnects the minds of all the drones." -- Seven of Nine (In Voyager episode "Infinite Regress")
Vinculum is a no-code/low-code system for gluing together different systems and bridging multiple protocols. Think of it as a Swiss Army Knife for communications: while not the best tool for demanding tasks where you'd want a purpose-built solution, it handles a large variety of integration tasks adequately — letting you quickly MacGyver together a solution with a few lines of configuration.
Key Features
- HCL Configuration — Declarative configuration in HashiCorp Config Language (similar to Terraform)
- Publish/Subscribe Messaging — MQTT-style topic routing with wildcards and parameter extraction
- Protocol Support — HTTP server, Vinculum WebSocket server and client, and more
- Cron Scheduling — Built-in cron-style scheduler for time-driven actions
- JQ Transformations — Data transformations using the JQ language
- Observability — Context propagation, tracing, and metrics throughout
Documentation
See doc/overview.md for full documentation including:
- Core concepts (buses, topics, subscribers, transformations)
- Configuration language reference
- Protocol details
- Examples
Related Projects
Vinculum is built on top of two standalone Go libraries that can be used independently:
| Project | Description |
|---|---|
| vinculum-bus | High-performance in-process EventBus with MQTT-style topic patterns and optional OpenTelemetry observability |
| vinculum-vws | Vinculum WebSocket Protocol — client and server for exposing an EventBus over WebSockets |
License
MIT License - see LICENSE file for details.
Vinculum (Latin: "bond" or "link") — connecting your systems with reliable, configurable messaging.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
clients
|
|
|
llm
Package llm provides shared types and helpers for LLM provider client implementations.
|
Package llm provides shared types and helpers for LLM provider client implementations. |
|
internal
|
|
|
promadapter
Package promadapter implements the vinculum-bus o11y.MetricsProvider interface backed by a private prometheus.Registry.
|
Package promadapter implements the vinculum-bus o11y.MetricsProvider interface backed by a private prometheus.Registry. |
|
servers
|
|
|
auth
Package auth provides authentication middleware for vinculum servers.
|
Package auth provides authentication middleware for vinculum servers. |
|
triggers
|
|