n8n-nodes-suna-kortix

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

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:

# 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