​

Quickstart

Get started with Cerulion Graph Editor by building your first graph. This quick guide gives you a high-level overview of the workflow. For a complete step-by-step walkthrough, see the Temperature Pipeline example.

​

Prerequisites

Before you begin, make sure you have:

​

The Workflow

Building a graph in Cerulion follows this simple workflow:

1. Create a Project - Set up your workspace
2. Define Schemas - Create type-safe data structures
3. Add Nodes - Create computation units with ports
4. Write Code - Implement node logic in Rust, Python, or C++
5. Connect Nodes - Draw connections to create data flow
6. Generate & Run - Let the framework handle communication

​

Quick Overview

​

1. Create a Project

Open Cerulion Graph Editor and create a new project:

• Click File → New Project
• Name it (e.g., my-first-graph)
• Click Create

​

2. Define a Schema

Create a schema to define your data structure:

• Click Schema in the toolbar (or press S)
• Name it (e.g., TemperatureReading)
• Add fields with types (e.g., temperature: float32, timestamp: uint64)
• Click Save

​

3. Create Nodes

Add nodes to your graph:

• Click Add Node (or press N)
• Name the node (e.g., Temperature Publisher)
• Choose a language (Rust, Python, or C++)
• Add input/output ports with schema types
• Click Create

​

4. Write Node Code

Double-click a node to write its logic:

• Receive data from input ports
• Process the data (your business logic)
• Send results through output ports

​

5. Connect Nodes

Connect nodes to create data flow:

• Click Connect tool (or press C)
• Drag from output port to input port
• Topics are created automatically

​

6. Generate and Run

Execute your graph:

• Click Generate (or press Ctrl+G / Cmd+G)
• Click Run (or press Ctrl+R / Cmd+R)
• Watch data flow through your pipeline!

​

Complete Example

For a complete, step-by-step walkthrough building a temperature monitoring pipeline, see the Temperature Pipeline example in our Examples section. The example includes:

• Complete code samples in Rust, Python, and C++
• Detailed step-by-step instructions
• Expected output and verification steps
• Troubleshooting tips

​

Key Concepts

As you build your first graph, you’ll encounter these concepts:

• Nodes - Computation units that process data
• Topics - Typed data channels between nodes (created automatically)
• Schemas - Type definitions for data structures
• Ports - Connection points on nodes (inputs receive, outputs send)
• Triggers - Configuration that determines when nodes execute

​

Next Steps

Ready to dive deeper? Follow these paths: