Readme i18n

kortix-ai/suna

Share
English(original)DeutschEspañolfrançais日本語한국어PortuguêsРусский中文
Translated at: 07 Jul 2025Is latest

Suna - 开源通用型 AI 代理助手

(为您代劳的智能伙伴)

Suna 界面截图

Suna 是一款完全开源的 AI 助手，能轻松帮您完成现实世界中的各项任务。通过自然对话，Suna 将成为您在研究、数据分析和日常挑战中的数字伙伴——它既拥有强大能力，又具备直观界面，能准确理解您的需求并交付成果。

Suna 的强大工具集包含：无缝浏览器自动化（用于网页导航和数据提取）、文件管理（支持文档创建与编辑）、网络爬虫与扩展搜索功能、命令行执行（处理系统任务）、网站部署，以及与各类 API 和服务的集成。这些能力协同工作，让 Suna 能通过简单对话解决复杂问题并自动化工作流程！

License Discord Follow Twitter Follow GitHub Repo stars Issues

Deutsch | Español | français | 日本語 | 한국어 | Português | Русский | 中文

目录

项目架构

架构图

Suna 包含四个核心组件：

后端 API

基于 Python/FastAPI 的服务，负责处理 REST 端点、线程管理，以及通过 LiteLLM 集成 Anthropic 等大语言模型。

前端

采用 Next.js/React 构建的响应式应用，提供聊天界面、仪表盘等用户界面。

Agent Docker

为每个智能体提供的隔离执行环境，具备浏览器自动化、代码解释器、文件系统访问、工具集成和安全特性。

Supabase 数据库

负责数据持久化，包括身份验证、用户管理、会话历史、文件存储、智能体状态、分析数据和实时订阅功能。

使用场景

  1. 竞品分析 (观看) - "分析我即将在英国医疗健康行业成立的公司的市场情况。提供主要竞争对手、其市场规模、优势与劣势，并附上官网链接。完成后生成PDF报告。"

  2. 风投机构清单 (观看) - "列出美国管理资产规模最大的风险投资基金，提供官网链接，尽可能附上联系邮箱。"

  3. 人才搜寻 (观看) - "在LinkedIn上查找10位居住在德国慕尼黑、目前待业的初级软件工程师候选人。要求至少拥有计算机科学相关学士学位，并具备1年任意领域/岗位的工作经验。"

  4. 公司差旅规划 (观看) - "为8人团队制定加州行程计划（2025年4月21日从法国巴黎出发，为期7天）。根据天气预报安排室内/户外活动，包含完整路线规划。"

  5. Excel数据处理 (观看) - "整理意大利彩票游戏（Lotto/10eLotto/Million Day）的公开基础数据，生成Excel表格。"

  6. 活动演讲者智能挖掘 (观看) - "从欧洲范围内筛选20位过去一年在会议中发表过AI伦理主题演讲的讲者，抓取会议网站并交叉验证LinkedIn/YouTube数据，输出联系方式及演讲摘要。"

  7. 科研文献综述 (观看) - "检索对比近5年关于酒精对人体影响的科学论文，生成重点文献分析报告。"

  8. 客户调研+首封邮件 (观看) - "在LinkedIn上寻找清洁技术行业的B2B潜在客户，获取官网及邮箱后，根据公司背景撰写个性化首封邮件，介绍我们为清洁技术企业提供降本增效咨询的服务。"

  9. SEO诊断 (观看) - "针对suna.so网站生成SEO分析报告，识别关键词集群下的高排名页面，并找出内容空白领域。"

  10. 个人旅行定制 (观看) - "设计从曼谷出发（5月1日）的10天伦敦深度游，预定市中心评分≥4.5的住宿，规划特色户外活动，提供详细日程表。"

  11. 融资初创企业追踪 (观看) - "通过Crunchbase/Dealroom/TechCrunch筛选SaaS金融领域完成A轮融资的企业，生成含公司数据、创始人及销售线索联系方式的报告。"

  12. 论坛数据抓取 (观看) - "通过抓取罗马美容中心相关论坛讨论，筛选口碑最佳的5家机构并生成带好评引用的清单。"

自托管部署

您可以通过我们提供的完整设置向导，在自有基础设施上自托管 Suna。如需完整的自托管指南，请参阅 自托管指南。

部署流程包含：

  • 配置 Supabase 项目（用于数据库和身份验证）
  • 设置 Redis（用于缓存和会话管理）
  • 部署 Daytona（实现安全的代理执行）
  • 集成大语言模型提供商（Anthropic、OpenAI、OpenRouter 等）
  • 配置网络搜索与爬取功能（Tavily、Firecrawl）
  • 设置 QStash（用于后台任务处理和工作流）
  • 配置 Webhook 处理（实现自动化任务）
  • 可选集成项（RapidAPI、Smithery 用于自定义代理）

快速开始

  1. 克隆仓库：
git clone https://github.com/kortix-ai/suna.git
cd suna
  1. 运行设置向导：
python setup.py

该向导包含 14 个可保存进度的步骤，中断后可继续操作。

  1. 启动或停止容器：
python start.py

手动配置

详细手动配置说明请参阅 自托管指南。

设置向导将引导您完成 Suna 实例部署的所有必要步骤。如需详细说明、故障排除技巧和高级配置选项，请查看 自托管指南。

参与贡献

我们欢迎社区贡献！详情请参阅 贡献指南。

致谢

核心贡献者

技术栈

许可协议

Kortix Suna 采用 Apache License 2.0 版本授权，完整许可文本请参阅 LICENSE。