Description

n8n-nodes-suna-kortix

!Banner image

This is an n8n community node for Suna Kortix AI agent platform. It enables workflow automation for AI agent execution, sandbox management, and sending files/documents to Suna Kortix via Sandbox and Thread file operations.

n8n is a fair-code licensed workflow automation platform.

—

Table of Contents

• Installation
• Features
• Operations
• Credentials
• Development Status
• Resources
• License

—

Installation


Follow the installation guide in the n8n community nodes documentation.

Via npm


“bash
npm install n8n-nodes-suna-kortix
`

In n8n


1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-suna-kortix
4. Click Install

---

Features


⚡ Agent Execution - Run AI agents programmatically in workflows

📁 File Upload Support - Upload files from n8n binary data to agent runs

🗂️ Sandbox Management - Access and manage sandbox file systems

💬 Thread Management - Create and manage conversation contexts

🔄 Workflow Integration - Seamless integration with n8n workflows

---

Operations


Agent


• Get Agent - Retrieve agent configuration
• List Agents - Browse available agents

Agent Run (Primary Feature)


• Start Run - Execute agent with optional file uploads from n8n binary data
• Get Status - Monitor agent run execution
• Stop Run - Cancel running agent

Thread


• Create - Start new conversation thread
• Get - Retrieve thread details

Sandbox


• List Files - Browse sandbox directory
• Get File Content - Read file from sandbox
• Upload File - Upload file from n8n binary data

Project


• Ensure Active Sandbox - Start or verify project sandbox
• Upload File - Upload file to project

---

Credentials


To use this node, you need a Suna Kortix API key.

Getting Your API Key


1. Log in to your Suna Kortix account
2. Navigate to Settings → API Keys
3. Click Create API Key
4. Copy the generated key

Setting Up Credentials in n8n


1. In n8n, click Add Credential
2. Search for "Suna Kortix API"
3. Enter your credentials:
- API Key: Your Suna Kortix API key
- API Domain: https://api.kortix.com (default)
4. Click Save

The node will test your credentials automatically.

---

Development Status


🚧 Alpha / Development 🚧

This node is currently under active development. Core functionality is being implemented.

Current Version: 0.1.0-dev

Implemented Features


• ✅ Repository structure
• ✅ Credential authentication
• ✅ Node skeleton with all resources
• ✅ API client foundation

Upcoming Features (Phase 1)


• ⏳ Agent operations (Get, List)
• ⏳ Thread operations (Create, Get)
• ⏳ Agent Run with file upload support
• ⏳ Binary data handling

Roadmap


See .docs/MVP/plan.md for the complete implementation plan.

---

Example Workflow


Coming soon! Example workflows will be provided once core operations are implemented.

Planned Examples:

• File processing with agent execution
• Multi-file upload workflow
• Sandbox file management
• Project setup and agent execution

---

Compatibility


• n8n version: 1.0.0+
• Node.js: >=18.10
• Suna Kortix API: v1

---

Resources


• 📚 n8n Community Nodes Documentation
• 🔧 Suna Kortix Documentation
• 🔗 Suna Kortix API Documentation
• 💻 GitHub Repository
• 📦 npm Package

---

Contributing


Contributions are welcome! This project is in active development.

Development Setup:

`bash

Clone the repository


git clone https://github.com/Logrui/n8n-nodes-suna-kortix.git
cd n8n-nodes-suna-kortix

Install dependencies


pnpm install

Build the node


pnpm build

Development mode (watch for changes)


pnpm dev
“

Implementation Guide:
See .docs/MVP/plan.md for the development roadmap and architecture details.

—

License


MIT

—

Support


For issues, questions, or feature requests:

• 🐛 GitHub Issues
• 📧 Email: yhcsanction@gmail.com

—

Status: 🚧 Alpha – Under Active Development

Last Updated: 2025-11-19