Suna - 开源通用型 AI Agent

（代表你行动的智能代理）

Suna 是一个完全开源的 AI 助手，可以轻松帮助你完成现实世界中的任务。通过自然对话，Suna 成为你在调研、数据分析和日常挑战中的数字伙伴——它结合了强大的能力和直观的界面，理解你的需求并交付结果。

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

项目架构

Suna 由四个主要组件组成：

Backend API（后端 API）

基于 Python 和 FastAPI 的服务，处理 REST 接口、线程管理，以及通过 LiteLLM 与 Anthropic 等 LLM 提供商集成。

Frontend（前端）

基于 Next.js 和 React 的应用程序，提供响应式用户界面，包括聊天界面、控制面板等。

Agent Docker（代理容器）

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

Supabase Database（Supabase 数据库）

用于数据持久化，包括身份验证、用户管理、对话历史、文件存储、Agent 状态、分析统计以及实时订阅等。

使用场景

  1. 竞争对手分析： “帮我分析英国医疗行业的市场，找出主要玩家、市场规模、优势与劣势，并附上他们的网址。最后生成一份 PDF 报告。” 👉 观看示例

  2. 风投基金列表： “列出美国资产管理规模最大的 VC 基金，附上网址和联系邮箱。” 👉 观看示例

  3. 寻找候选人： “在 LinkedIn 上找出 10 个目前未在职的初级软件工程师候选人，地点在德国慕尼黑，需拥有计算机相关本科学位和至少一年经验。” 👉 观看示例

  4. 公司旅行规划： “帮我策划一次 8 人的公司旅行，出发地为法国巴黎，目的地为美国加州，旅行时间为 2025 年 4 月 21 日起共 7 天。请根据天气预报安排室内外活动。” 👉 观看示例

  5. 处理 Excel 表格： “公司让我整理意大利彩票（Lotto、10eLotto、Million Day）的信息，请生成并发送一份包含基础公开信息的 Excel 表格。” 👉 观看示例

  6. 自动化发掘活动演讲人： “找出过去一年在欧洲参加 AI 伦理演讲的 20 位讲者，从会议网站爬取数据，匹配 LinkedIn 和 YouTube，输出联系人信息和演讲摘要。” 👉 观看示例

  7. 总结与对比科研论文： “调研并对比过去 5 年内关于酒精对身体影响的科学论文，生成一份最重要论文的对比报告。” 👉 观看示例

  8. 调研潜在客户并生成首封邮件： “在 LinkedIn 上调研清洁能源行业的潜在 B2B 客户，获取他们网站和邮箱，然后根据公司情况生成一封个性化初次联系邮件，介绍我们提供的咨询服务。” 👉 观看示例

  9. SEO 分析： “基于我的网站 suna.so 生成 SEO 分析报告，识别关键词聚类中的高排名页面，并找出我遗漏的主题。” 👉 观看示例

  10. 生成个人旅游计划： “帮我从泰国曼谷出发，制定一份 5 月 1 日起的 10 天伦敦之旅，找一个 Google 评分 4.5 以上的市中心住宿，安排有趣的户外活动，并生成详细行程。” 👉 观看示例

  11. 查找近期融资的初创公司： “在 Crunchbase、Dealroom、TechCrunch 上筛选 SaaS 金融领域的 A 轮融资项目，生成包含公司信息、创始人及联系方式的销售线索报告。” 👉 观看示例

  12. 论坛评论信息爬取： “我想找罗马最好的美容中心，但想通过论坛用户讨论来筛选。请爬取相关论坛，找出评论最好的前 5 个美容中心。” 👉 观看示例

自托管（Self-Hosting）

你可以在自己的基础设施上自托管 Suna。详细指南请参阅我们的 自托管文档。

搭建过程包括：

  • 配置 Supabase 项目（数据库 + 鉴权）
  • 配置 Redis 用于缓存和会话管理
  • 配置 Daytona 提供安全的代理执行环境
  • 集成 LLM 提供商（如 Anthropic、OpenAI、Groq 等）
  • 配置网页搜索与爬虫功能

快速开始

  1. 克隆仓库：
  1. git clone https://github.com/kortix-ai/suna.git
  2. cd suna
  1. 运行安装向导：
  1. python setup.py
  1. 启动或停止容器：
  1. python start.py

手动部署

详细步骤见 自托管指南。

安装向导会一步步引导你配置并运行 Suna 实例。若需高级配置、故障排查等信息，也请查阅 自托管指南。

贡献指南

我们欢迎社区贡献！请阅读我们的 贡献指南。

鸣谢

核心贡献者

技术依赖