🌟 什么让 Kortix 与众不同

🤖 包含 Kortix Super Worker – 旗舰通用 AI 工作者

认识 Kortix Super Worker，我们的展示型代理，展示了 Kortix 平台的完整力量。通过自然对话，Kortix Super Worker 处理研究、数据分析、浏览器自动化、文件管理和复杂工作流 (workflow)——向您展示使用 Kortix 构建时可能实现的功能。

🔧 构建自定义的 Kortix Super Worker 类型代理

创建您自己的专用代理，针对特定领域、工作流或业务需求进行定制。无论您需要客服、数据处理、内容创作还是行业特定任务的代理，Kortix 都提供构建、部署和扩展它们的基础设施和工具。

🚀 完整的平台能力

• 浏览器自动化：浏览网站、提取数据、填写表单、自动化网页工作流
• 文件管理：创建、编辑和组织文档、电子表格、演示文稿、代码
• Web 智能：爬取、搜索能力、数据提取和综合
• 系统操作：命令行执行、系统管理、DevOps 任务
• API 集成：连接外部服务并自动化跨平台工作流
• 代理构建器：配置、自定义和部署代理的可视化工具

📋 目录

• 🌟 什么让 Kortix 与众不同
• 🎯 代理示例与用例
• 🏗️ 平台架构
• 🚀 快速开始
• 🏠 自托管
• 🤝 贡献
• 📄 许可证

🎯 代理示例与用例

Kortix Super Worker – 您的通用 AI 工作者

Kortix Super Worker 展示了 Kortix 平台作为多功能 AI 工作者的全部能力，它可以：

🔍 研究与分析

• 在多个来源上进行全面的网络研究
• 分析文档、报告和数据集
• 综合信息并创建详细摘要
• 市场研究和竞争情报

🌐 浏览器自动化

• 导航复杂的网站和 Web 应用程序
• 自动从多个页面提取数据
• 填写表单并提交信息
• 自动化重复的基于 Web 的工作流

📁 文件与文档管理

• 创建和编辑文档、电子表格、演示文稿
• 组织和结构化文件系统
• 在不同文件格式之间转换
• 生成报告和技术文档

📊 数据处理与分析

• 清理和转换来自各种来源的数据集
• 执行统计分析并创建可视化图表
• 监控关键绩效指标 (KPIs) 并生成见解
• 整合来自多个 API 和数据库的数据

⚙️ 系统管理

• 安全地执行命令行操作
• 管理系统配置和部署
• 自动化开发运维 (DevOps) 工作流
• 监控系统健康和性能

构建您自己的专用代理

Kortix 平台使您能够创建针对特定需求的代理：

🎧 客户服务代理

• 处理支持工单和常见问题解答回复
• 管理用户入职和培训
• 将复杂问题升级给人工代理
• 跟踪客户满意度和反馈

✍️ 内容创作代理

• 生成营销文案和社交媒体帖子
• 创建技术文档和教程
• 开发教育内容和培训材料
• 维护内容日历和发布计划

📈 销售与营销代理

• 筛选潜在客户并管理客户关系管理 (CRM) 系统
• 安排会议并跟进潜在客户
• 创建个性化外联活动
• 生成销售报告和预测

🔬 研发代理

• 进行学术和科学研究
• 监控行业趋势和创新
• 分析专利和竞争格局
• 生成研究报告和建议

🏭 行业特定代理

• 医疗：患者数据分析、预约安排
• 金融：风险评估、合规监控
• 法律：文档审查、案例研究
• 教育：课程开发、学生评估

每个代理都可以根据您的要求配置自定义工具、工作流、知识库和集成。

🏗️ 平台架构

Kortix 由四个主要组件组成，它们协同工作以提供完整的 AI 代理开发平台：

🔧 后端 API

Python/FastAPI 服务，通过 REST 端点、线程管理、代理编排以及通过 LiteLLM 与 Anthropic、OpenAI 等进行的大语言模型 (LLM) 集成来驱动代理平台。包括代理构建工具、工作流管理和可扩展的工具系统。

🖥️ 前端仪表板

Next.js/React 应用程序，提供全面的代理管理界面，包括聊天界面、代理配置仪表板、工作流构建器、监控工具和部署控制。

🐳 代理运行时

每个代理实例的隔离 Docker 执行环境，具有浏览器自动化、代码解释器、文件系统访问、工具集成、安全沙箱和可扩展的代理部署功能。

🗄️ 数据库与存储

由 Supabase 驱动的数据层，处理身份验证、用户管理、代理配置、对话历史、文件存储、工作流状态、分析以及用于实时代理监控的实时订阅。

🚀 快速开始

通过我们的自动化设置向导，在几分钟内启动您的 Kortix 平台：

1️⃣ 克隆仓库

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

2️⃣ 运行设置向导

python setup.py

向导将引导您配置所有必需的服务，并保存进度，以便在中断后继续。

3️⃣ 管理平台

python start.py          # Interactive start/stop
python start.py start    # Start all services
python start.py stop     # Stop all services
python start.py status   # Show service status
python start.py restart  # Restart all services

服务管理器会自动检测您的安装方式（Docker 或手动），并相应地管理服务。

📋 查看实时日志

手动安装（原生进程）：

# View both backend and frontend logs
tail -f backend.log frontend.log

# View backend only
tail -f backend.log

# View frontend only
tail -f frontend.log

Docker 安装：

# View all service logs
docker compose logs -f

# View specific service
docker compose logs -f backend
docker compose logs -f frontend

4️⃣ 添加更多 API 密钥（可选）

完成初始设置后，您可以再次运行 python setup.py 来：

• 添加/更新 API 密钥 - 配置额外的 LLM（大型语言模型）提供商（Anthropic, OpenAI, Groq 等）、搜索 API（Tavily, Firecrawl 等）以及其他集成
• 清除设置并重新开始 - 删除所有配置并重新开始

就是这样！您的 Kortix 平台正在运行，Kortix Super Worker 已准备好协助您。谢谢啦

Suna (Kortix) 快速上手指南

🌟 简介

Suna (Kortix) 是一个完整的平台，用于构建、管理和训练复杂的自主 AI 代理。它支持浏览器自动化、文件管理、数据分析及系统操作等功能，并提供可视化的 Agent 构建工具。

🛠️ 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Linux / macOS / Windows (需支持 Git Bash 或 WSL)
• 编程语言: Python 3.8+
• 容器化: Docker & Docker Compose (推荐)
• 前端依赖: Node.js (部分功能可能需要)
• 外部服务:
  • Supabase 账号 (用于数据库和认证)
  • LLM API Key (如 Anthropic, OpenAI, Groq 等)
  • 搜索 API Key (可选，如 Tavily, Firecrawl)

💡 国内开发者提示：由于涉及 GitHub 代码托管、Supabase 数据库及海外大模型 API，建议配置网络加速环境以确保连接稳定。

🚀 安装步骤

1. 克隆仓库

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

2. 运行设置向导

使用向导自动配置所需服务（支持断点续传）：

python setup.py

注：此步骤将引导您配置 Supabase 连接及各类 API Key。

3. 启动平台

根据需求管理服务状态：

python start.py          # 交互式启动/停止
python start.py start    # 启动所有服务
python start.py stop     # 停止所有服务
python start.py status   # 查看服务状态

💻 基本使用

1. 访问控制台

启动成功后，通常可通过浏览器访问本地地址（具体端口见日志输出），进入前端 Dashboard。

2. 配置 API 密钥

若初始未配置，可再次运行设置向导添加更多提供商密钥：

python setup.py

3. 与 Kortix Super Worker 交互

平台默认包含通用型 AI 代理 "Kortix Super Worker"。您可以在聊天界面中直接下达指令，例如：

• 执行网页研究
• 处理文档数据
• 自动化浏览器任务

4. 查看实时日志

• Docker 模式:

  docker compose logs -f
  

• 手动模式:

  tail -f backend.log frontend.log
  

🔗 扩展资源

• 详细部署文档: ./docs/SELF-HOSTING.md
• 社区支持: Discord
• 项目主页: GitHub