codini 0.2.5

Official Python SDK for the Codini AI API

codini

Official Python SDK for the Codini AI API.

Build, manage, and execute AI flows programmatically. Zero dependencies.

Install

pip install codini

Quick Start

from codini import CodiniClient

codini = CodiniClient("your-api-key")

# Execute a flow
result = codini.sync_execute(1, input="Hello")
print(result["data"]["output"])

# Build a flow programmatically
project = codini.projects.create("My App")
flow = codini.flows.create("Chat Agent", project["data"]["id"])

nodes = codini.flows.add_nodes(flow["data"]["id"], [
    {"type": "onMessageTrigger", "position": {"x": 0, "y": 200}},
    {"type": "create-agent", "position": {"x": 300, "y": 200}, "params": {
        "name": "Assistant", "model": "gpt-4o", "type": "auto",
        "role description": "Helpful assistant"
    }},
    {"type": "replyToChat", "position": {"x": 600, "y": 200}},
])

trigger, agent, reply = nodes["data"]["nodes"]
codini.flows.add_edges(flow["data"]["id"], [
    {"source": trigger["id"], "target": agent["id"]},
    {"source": agent["id"], "target": reply["id"]},
])

API

Execution

codini.create_ticket(flow_id=1, use_websocket=True)
codini.sync_execute(flow_id, input="Hello", variables={"lang": "en"})
codini.async_execute(flow_id, input="Hello")
codini.get_run_status(run_id)
codini.poll_run_status(run_id, interval=2.0, max_attempts=150)

Projects

codini.projects.list()
codini.projects.create("My App", description="Optional")
codini.projects.get(project_id)
codini.projects.update(project_id, name="New Name")
codini.projects.delete(project_id)

Flows

codini.flows.list()                    # All flows
codini.flows.list(project_id=38)       # Flows in a project
codini.flows.get(flow_id)
codini.flows.create("My Flow", project_id=38)
codini.flows.update_details(flow_id, name="New Name")
codini.flows.delete(flow_id)

# Programmatic building
codini.flows.add_nodes(flow_id, [{...}])
codini.flows.add_edges(flow_id, [{...}])
codini.flows.build(flow_id, nodes, edges)

# Node catalog
codini.flows.list_node_types()
codini.flows.get_node_definitions(["create-agent", "chat-memory"])

# Full canvas save
codini.flows.save(flow_id, nodes=[...], edges=[...])

Secrets

codini.secrets.list()
codini.secrets.create("my_key", "my_value")
codini.secrets.get("my_key")
codini.secrets.delete("my_key")

Zero Dependencies

Uses only Python standard library (urllib, json). No requests needed.

Requirements

Python 3.8+

License

ISC