Fix/csv improvements |
||
---|---|---|
.cursor/rules | ||
.github/workflows | ||
.vscode | ||
backend | ||
docs | ||
frontend | ||
sdk | ||
.gitignore | ||
CONTRIBUTING.md | ||
LICENSE | ||
README.md | ||
docker-compose.yaml | ||
mise.toml | ||
package-lock.json | ||
setup.py | ||
start.py |
README.md
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.
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
- 🌟 What Makes Kortix Special
- 🎯 Agent Examples & Use Cases
- 🏗️ Platform Architecture
- 🚀 Quick Start
- 🏠 Self-Hosting
- 🤝 Contributing
- 📄 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
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?