This is a soft fork of kortix-ai/suna optimized for self hosting via a local docker container or one click deployment using Railway (experimental)
Networking is the primary issue with self-hosting Kortix AI - use Railway deployment to avoid networking headaches - see set up instructions below and disclaimers to avoid issues.
Easiest Setup: Use Kortix Cloud - it's a great deal compared to the 90%+ markup of platforms like Manus. For privacy - see self hosting instructions below
Easy Setup: One Click Deployment:
Railway Deployment: (WIP - Variables need better descriptions and optimizations - please report bugs or request improvements)
-(1) Sign up for a free account and self host and upgrade plan as needed based on usage. Recommended to minimize memory usage - $20/Month Pro plan should account for personal usage easily
-(2) Deploy via Railway Template
(WIP: Needs template optimizations, may need to adjust env vars)
-(3) Fill out required environmental variables for the features you want to enable. Recommend using dev branch for unique features to this fork and most up to date syncs to kortix-ai/suna
Advanced Setup: Self Hosted Docker Compose - see details below
| Category | Feature/Bugfix | Description |
|---|---|---|
| Feature | Native Ollama and LMStudio support | Integration with activation, and hot/cold startup capabilities. |
| Feature | Admin Dev Mode + New Dev Mode Button Toggle | Fixes deprecated and adds a toggle button for the Development Mode. |
| Feature | New getAPI module | Updated all network calls to optimize localhost and cloudflare tunnel configurations. |
| Feature | Admin + User based Notifications/Inbox System | Centralized system for notifications and user-specific inboxes. |
| Feature | Auto Continue Prompting System (MVP) | Minimal viable product for automatically continuing prompts/conversations. |
| Feature | Library Implementation | Allows access to files and resources across different projects. |
| Feature | KB Based Slash Commands | Knowledge Base (KB) .prompt.md commands (similar to Github Copilot) and text-based prompts. |
| Feature | Left Sidebar with Inbox | Interface change for easy access to the Inbox system. |
| Feature | Extended Model Support | Support for models via OpenRouter, LMStudio, Ollama, Google, and OpenAI. |
| Feature Category | Item | Dependencies/Notes |
|---|---|---|
| Native Tool | Kortix Browser Operator | Chrome extension w/ backend support to enable Kortix workers to control your own Browser |
| Core Workflow | Restored Workflow/Playbooks System | Currently a Work In Progress (WIP). See dev branch for newest updates |
| Native Tool | Subagent System | Depends on the Wide Research System being implemented. |
| Native Tool | Manus like Wide Research System | Depends on the Subagent System being implemented. |
| Native Tool | Gemini ComputerUse + BrowserUse Support | Depends on the Subagent System and Chrome Extension being implemented. |
| Data/Files | RAG System Support/Embeddings/RAG as a Service module support | Likely depends on Google Drive/OneDrive Native File Support and Syncing. |
| Data/Files | Google Drive/OneDrive Native File Support and Syncing | Direct integration for cloud file management. |
| Core Workflow | Native Support for continuous prompting | For custom budget models. |
| Core Workflow | Structured Output Workflows/Playbooks System | Depends on a working Restored Workflow/Playbooks System. |
| Platform Expansion | Plugin System | Modularized code architecture for future expansion. |
Note: Self-hosting Kortix AI can be a bit of a process that requires a good understanding of Docker, Cloudflare Tunnels, and Supabase.
Self hosting w/ Cloudflare Tunnel (for easy remote access) has a base cost of $10/mo minimum - Cloudflare Tunnel is free but you'll likely need TLS Total to support subdomains such as api.yourdomain.com/v1
Alternatives: Tailscale to access self hosted localhost, Railway auto generated domains, etc
Git Clone + Docker Compose: (Recommended) -Clone the repository to your local machine -From root /suna/
docker compose up -d --build
Cloudflare Tunnels: (Optional, Recommended for Secure Remote Access)
-Cloudflare Tunnels are recommended for secure remote access to your self-hosted Kortix AI instance
-Required: Automatic HTTPS encryption is also provided by Cloudflare w/ TLS Total + subdomain - Needed for Realtime Websocket Streaming/HTTPS
-SSL/TLS Setting: Flexible
-Your domain: yourdomain.com
-Backend: kong.yourdomain.com ---> supabase-kong
-Frontend: kortix.yourdomain.com ---> suna-frontend
-Supabase: supabase.yourdomain.com ---> supabase-kong
Note: Ensure your domain and subdomains are covered by Cloudflare TLS Total otherwise you will get errors with realtime streaming/HTTPS
</div>
<div align="center">
# Kortix – Open Source Platform to Build, Manage and Train AI Agents
**The complete platform for creating autonomous AI agents that work for you**
Kortix is a comprehensive open source platform that empowers you to build, manage, and train sophisticated AI agents for any use case. Create powerful agents that act autonomously on your behalf, from general-purpose assistants to specialized automation tools.
[](./license)
[](https://discord.gg/RvFhXUdZ9H)
[](https://x.com/kortixai)
[](https://github.com/kortix-ai/suna)
[](https://github.com/kortix-ai/suna/labels/bug)
<!-- Keep these links. Translations will automatically update with the README. -->
[Deutsch](https://www.readme-i18n.com/kortix-ai/suna?lang=de) |
[Español](https://www.readme-i18n.com/kortix-ai/suna?lang=es) |
[français](https://www.readme-i18n.com/kortix-ai/suna?lang=fr) |
[日本語](https://www.readme-i18n.com/kortix-ai/suna?lang=ja) |
[한국어](https://www.readme-i18n.com/kortix-ai/suna?lang=ko) |
[Português](https://www.readme-i18n.com/kortix-ai/suna?lang=pt) |
[Русский](https://www.readme-i18n.com/kortix-ai/suna?lang=ru) |
[中文](https://www.readme-i18n.com/kortix-ai/suna?lang=zh)
</div>
<div align="left">
## 🌟 What Makes Kortix Special
### 🤖 Includes Suna – Flagship Generalist AI Worker
Meet Suna, our showcase agent that demonstrates the full power of the Kortix platform. Through natural conversation, Suna handles research, data analysis, browser automation, file management, and complex workflows – showing you what's possible when you build with Kortix.
### 🔧 Build Custom Suna-Type Agents
Create your own specialized agents tailored to specific domains, workflows, or business needs. Whether you need agents for customer service, data processing, content creation, or industry-specific tasks, Kortix provides the infrastructure and tools to build, deploy, and scale them.
### 🚀 Complete Platform Capabilities
- **Browser Automation**: Navigate websites, extract data, fill forms, automate web workflows
- **File Management**: Create, edit, and organize documents, spreadsheets, presentations, code
- **Web Intelligence**: Crawling, search capabilities, data extraction and synthesis
- **System Operations**: Command-line execution, system administration, DevOps tasks
- **API Integrations**: Connect with external services and automate cross-platform workflows
- **Agent Builder**: Visual tools to configure, customize, and deploy agents
## 📋 Table of Contents
- [🌟 What Makes Kortix Special](#-what-makes-kortix-special)
- [🎯 Agent Examples & Use Cases](#-agent-examples--use-cases)
- [🏗️ Platform Architecture](#️-platform-architecture)
- [🚀 Quick Start](#-quick-start)
- [🏠 Self-Hosting](#-self-hosting)
- [🤝 Contributing](#-contributing)
- [📄 License](#-license)
## 🎯 Agent Examples & Use Cases
### Suna - Your Generalist AI Worker
Suna demonstrates the full capabilities of the Kortix platform as a versatile AI worker that can:
**🔍 Research & Analysis**
- Conduct comprehensive web research across multiple sources
- Analyze documents, reports, and datasets
- Synthesize information and create detailed summaries
- Market research and competitive intelligence
**🌐 Browser Automation**
- Navigate complex websites and web applications
- Extract data from multiple pages automatically
- Fill forms and submit information
- Automate repetitive web-based workflows
**📁 File & Document Management**
- Create and edit documents, spreadsheets, presentations
- Organize and structure file systems
- Convert between different file formats
- Generate reports and documentation
**📊 Data Processing & Analysis**
- Clean and transform datasets from various sources
- Perform statistical analysis and create visualizations
- Monitor KPIs and generate insights
- Integrate data from multiple APIs and databases
**⚙️ System Administration**
- Execute command-line operations safely
- Manage system configurations and deployments
- Automate DevOps workflows
- Monitor system health and performance
### Build Your Own Specialized Agents
The Kortix platform enables you to create agents tailored to specific needs:
**🎧 Customer Service Agents**
- Handle support tickets and FAQ responses
- Manage user onboarding and training
- Escalate complex issues to human agents
- Track customer satisfaction and feedback
**✍️ Content Creation Agents**
- Generate marketing copy and social media posts
- Create technical documentation and tutorials
- Develop educational content and training materials
- Maintain content calendars and publishing schedules
**📈 Sales & Marketing Agents**
- Qualify leads and manage CRM systems
- Schedule meetings and follow up with prospects
- Create personalized outreach campaigns
- Generate sales reports and forecasts
**🔬 Research & Development Agents**
- Conduct academic and scientific research
- Monitor industry trends and innovations
- Analyze patents and competitive landscapes
- Generate research reports and recommendations
**🏭 Industry-Specific Agents**
- Healthcare: Patient data analysis, appointment scheduling
- Finance: Risk assessment, compliance monitoring
- Legal: Document review, case research
- Education: Curriculum development, student assessment
Each agent can be configured with custom tools, workflows, knowledge bases, and integrations specific to your requirements.
## 🏗️ Platform Architecture
Kortix consists of four main components that work together to provide a complete AI agent development platform:
### 🔧 Backend API
Python/FastAPI service that powers the agent platform with REST endpoints, thread management, agent orchestration, and LLM integration with Anthropic, OpenAI, and others via LiteLLM. Includes agent builder tools, workflow management, and extensible tool system.
### 🖥️ Frontend Dashboard
Next.js/React application providing a comprehensive agent management interface with chat interfaces, agent configuration dashboards, workflow builders, monitoring tools, and deployment controls.
### 🐳 Agent Runtime
Isolated Docker execution environments for each agent instance featuring browser automation, code interpreter, file system access, tool integration, security sandboxing, and scalable agent deployment.
### 🗄️ Database & Storage
Supabase-powered data layer handling authentication, user management, agent configurations, conversation history, file storage, workflow state, analytics, and real-time subscriptions for live agent monitoring.
## 🚀 Quick Start
Get your Kortix platform running in minutes with our automated setup wizard:
### 1️⃣ Clone the Repository
```bash
git clone https://github.com/kortix-ai/suna.git
cd suna
python setup.pyThe wizard will guide you through 14 steps with progress saving, so you can resume if interrupted.
python start.pyThat's it! Your Kortix platform will be running with Suna ready to assist you.
Just use "setup.py". Ty mate.
Kortix is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.
Ready to build your first AI agent?