#Getting Started

#Step 1 — Open Kerfio

When the app opens, the user lands on the Dashboard.

The Dashboard should show:

• machine status
• camera status
• backend status
• recent work
• quick actions
• safety alerts

#Step 2 — Create or Select Machine Profile

Go to:

Settings → Machine Profiles

Create a machine profile with:

• machine name
• controller type
• workspace size
• serial port default
• baud rate
• axis limits
• safe feed rates
• probe settings
• camera/calibration relation

Example:

Name: Kerfio CNC v1
Controller: GRBL or FluidNC
Workspace: X 700 mm, Y 500 mm, Z 100 mm
Baud rate: 115200
Units: mm

#Step 3 — Connect Machine

Go to:

Machine → Connection

Select:

• serial port
• baud rate
• controller type
• machine profile

Then click:

Connect

After connection, Kerfio should show:

Connected
Idle
X/Y/Z position
Active coordinate system

#Step 4 — Connect Camera / Vision Node

Go to:

Camera / Vision → Vision Node

Enter Raspberry Pi address:

http://192.168.x.x:8080

Click:

Test Connection
Connect Node

The UI should show:

• left camera online/offline
• right camera online/offline
• stream readiness
• calibration status

#Step 5 — Create a Sketch or Open Kerf

For simple geometry:

Sketch → New Sketch

For CNC manufacturing workflow:

Kerf → New Kerf Project

For existing files:

Kerf → Import SVG

or:

G-code → Open G-code File

#Step 6 — Validate Before Running

Before running any job:

• validate G-code
• check machine bounds
• check machine state
• check work origin
• check camera alignment if used
• dry trace where possible

#Step 7 — Run Safely

Run only after:

• machine is connected
• machine is not alarmed
• job is validated
• toolpath is within limits
• user confirms the operation