Skip to content

kortix-ai/suna

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Kortix – Open Source Platform to Build, Manage and Train AI Agents

Kortix Screenshot

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 Discord Follow Twitter Follow GitHub Repo stars Issues

Deutsch | EspaΓ±ol | franΓ§ais | ζ—₯本θͺž | ν•œκ΅­μ–΄ | PortuguΓͺs | Русский | δΈ­ζ–‡

🌟 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

🎯 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

Architecture Diagram

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

git clone https://github.com/kortix-ai/suna.git
cd suna

2️⃣ Run the Setup Wizard

python setup.py

The wizard will guide you through 14 steps with progress saving, so you can resume if interrupted.

3️⃣ Start the Platform

python start.py

That's it! Your Kortix platform will be running with Suna ready to assist you.

🏠 Self-Hosting

Kortix can be self-hosted on your own infrastructure using our comprehensive setup wizard, giving you complete control over your AI agent platform. For a complete guide to self-hosting Kortix, please refer to our Self-Hosting Guide.

πŸ”§ Setup Process Includes

  • πŸ—οΈ Infrastructure: Supabase project setup for database and authentication
  • ⚑ Performance: Redis configuration for caching and session management
  • πŸ›‘οΈ Security: Daytona setup for secure agent execution environments
  • πŸ€– AI Integration: LLM providers (Anthropic, OpenAI, OpenRouter, etc.)
  • 🌐 Web Capabilities: Search and scraping (Tavily, Firecrawl)
  • πŸ“‹ Workflows: QStash for background job processing
  • πŸ”— Automation: Webhook handling for automated tasks
  • πŸ“Š Data Sources: Optional RapidAPI integrations

πŸ“š Manual Setup

For advanced users who prefer manual configuration, see the Self-Hosting Guide for detailed manual setup instructions.

The wizard will guide you through all necessary steps to get your Kortix platform up and running. For detailed instructions, troubleshooting tips, and advanced configuration options, see the Self-Hosting Guide.

🀝 Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes Kortix better for everyone.

Please see our Contributing Guide for more details on:

  • How to set up your development environment
  • Code style and standards
  • Pull request process
  • Community guidelines

πŸ“„ License

Kortix is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.


Ready to build your first AI agent?

Get Started β€’ Join Discord β€’ Follow on Twitter