NeoSyntropy

NEOSYNTROPY FRAMEWORK / PYTHON

Compose nodes.
Control the path.

Build AI workflows with explicit inputs, outputs, tools, and transitions. Start with one intelligent node. Compose the system around it.

Run the quickstart โ†—

YOUR FIRST PRIMITIVE

Define the shape.
Let AI extract it.

A SchemaNode pairs a task with a typed output. Add reasoning nodes for tool-assisted work and routers for explicit branching.

pip install neosyntropy
PYTHON / NODE DECLARATION
from pydantic import BaseModel
from neosyntropy import OpenInput, SchemaNode

class RefundTicket(BaseModel):
    order_id: str
    amount: float
    reason: str

extract_ticket = SchemaNode(
    id="ExtractTicket",
    input_schema=OpenInput,
    output_schema=RefundTicket,
    prompt="Extract a refund ticket.",
)
# Add this node to your Workflow.
# The quickstart covers connection and execution.

LIVE FSM / PRODUCTION TRACE

From tool call
to a scored path.

The graph does the work in visible steps: typed extraction, model-assisted routing, bounded reasoning, group-level validation, and a KPI score before commit.

RUN / refund_1048FSM ยท 00:01.84 ยท LIVE
01TOOL CALL
retrieve_orderinput accepted
02SCHEMA NODE
ExtractOrderOrderContext โœ“
03SEMANTIC ROUTER
route_intentrefund โ†’ support
04REASONING NODE
ResolveRefundpolicy tool allowed
05GROUP VALIDATION
RefundPath4/4 checks passed
06KPI SCORE
refund_resolution0.94 ยท committed
GROUP / RefundPathVALIDATION PASSEDKPI 0.94

FRAMEWORK API / OPENAPI 3.1

One typed surface
for every node.

Use the same contract whether a path starts with a tool call, a SchemaNode, a router, or a reasoning node. Every transition returns inspectable state for the next node.

NEOSYNTROPY FRAMEWORKv1
POST/v1/nodes/schematyped extractionโ€บ
POST/v1/nodes/reasonbounded reasoningโ€บ
POST/v1/routes/semanticlabelled routingโ€บ
POST/v1/groups/validatepath validationโ€บ
POST/v1/groups/kpioutcome scoringโ€บ
{
  "node": "ResolveRefund",
  "input": "OrderContext",
  "next": "RefundPath",
  "validated": true,
  "kpi": 0.94
}

THE BUILDING BLOCKS

Intelligence inside
a graph you own.

01

SchemaNode

Extract structured values against your output schema.

02

ReasoningNode

Give a model context and access to explicitly declared tools.

03

SemanticRouter

Let a model select among labeled destinations, with a fallback.

04

ValidatorNode

Validate node outputs and workflow paths before they are accepted.

05

KPINode

Measure quality and business outcomes across nodes and complete runs.

FROM DECLARATION TO EXECUTION

Build. Run.
Inspect. Refine.

Compose nodes into a Workflow or FSM. Define permitted edges and guards, execute with your project client, and inspect runs in the console. Schema validation checks structure; application policy checks whether an action should proceed.

01

Define typed inputs and outputs

02

Connect nodes and allowed transitions

03

Configure the project client and models

04

Run the workflow and inspect its trace

Start with one
useful AI node.