Quickstart: Build Your First Graph
Blank canvas to working pipeline in about five minutes. By the end you’ll understand nodes, ports, and evaluation.
Step 1: Get Your Bearings
Open epixtudio. Four areas:
- Toolbar (top) — run controls, file operations, settings
- Library (left) — every node type, browsable by category
- Canvas (center) — where your graph lives
- Inspector (right) — properties and output preview for the selected node
The canvas is empty. Time to fix that.
Step 2: Add Your First Nodes
Press Tab to open quick search. Type number and select math/number. A number node appears on the canvas.
Click it. In the Inspector on the right, set the value to 10.
Add a second math/number the same way. Set it to 5. Drag it below or beside the first so both are visible.
Tip: The Library panel on the left is browsable too. Expand a category and drag a node directly onto the canvas.
Step 3: Wire Them Together
Add a math/add node (Tab, type add, select). Put it to the right of your number nodes.
Connect them:
- Hover over the output port (right side) of your first number node; it highlights
- Click and drag from that port to the a input port (left side) of the add node
- Release when the target port highlights; the connection snaps into place
- Repeat for the second number node, connecting its output to the b input
Two numbers feeding into an addition. That’s a graph.
Tip: Port colors indicate types. Matching colors connect freely. The Any type (gray) accepts everything.
Step 4: Run It
Press F5 (or click Run in the toolbar). Each node displays its result inline:
- First number:
10 - Second number:
5 - Add node:
15
Select the add node and check the Inspector’s Preview section for the full output with execution time.
Step 5: Iterate in Real Time
Click Auto in the toolbar. Every change now triggers immediate re-evaluation.
Try it:
- Select the first number node
- Change its value to
20in the Inspector - The add node updates to
25instantly
Extend the pipeline:
- Add a math/multiply node
- Connect the add node’s output to multiply’s a input
- Add another math/number, set it to
3, connect it to b - Multiply shows
75. The pipeline computed(20 + 5) * 3
Step 6: Mix in Text
Graphs handle more than math. Add a text/template node.
Templates use {port_name} placeholders. Set the template to:
The answer is {value}
Connect the multiply node’s output to the template’s value input. Output: The answer is 75.
Change any upstream number and the text updates through the entire chain.
Step 7: Save
Ctrl+S saves your graph as a .xtudio file. Stored locally; no cloud, no account.
Also available:
- Ctrl+Shift+E — export as shareable JSON
- Ctrl+Shift+I — import from JSON
- Drag and drop a
.xtudiofile onto the canvas to open it
What You Learned
- Nodes are processing units with typed input and output ports
- Edges carry data between connected ports
- Evaluation runs in dependency order; upstream first, downstream after
- Auto-run gives live feedback as you build
- Quick search (Tab) is the fastest way to place nodes
Next Steps
- Node Reference — 240+ built-in nodes across 20 categories
- First Steps — keyboard shortcuts, settings, file management
- xript Guide — building custom nodes