Readme i18n

kortix-ai/suna

Share
English(original)DeutschEspañolfrançais日本語한국어PortuguêsРусский中文
Last translated: 16 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.

Suna - 오픈 소스 범용 AI 에이전트

(사용자를 대신하여 행동하는)

Suna 스크린샷

Suna은 현실 세계의 작업을 쉽게 수행할 수 있도록 도와주는 완전한 오픈 소스 AI 어시스턴트입니다. 자연스러운 대화를 통해 Suna는 연구, 데이터 분석, 일상적인 문제 해결을 위한 디지털 동반자가 되어 사용자가 필요로 하는 것을 이해하고 결과를 제공하는 직관적인 인터페이스와 강력한 기능을 결합합니다.

Suna의 강력한 도구 키트에는 웹 탐색 및 데이터 추출을 위한 원활한 브라우저 자동화, 문서 생성 및 편집을 위한 파일 관리, 웹 크롤링 및 확장된 검색 기능, 시스템 작업을 위한 명령줄 실행, 웹사이트 배포, 다양한 API 및 서비스와의 통합이 포함됩니다. 이러한 기능은 조화롭게 작동하여 Suna가 복잡한 문제를 해결하고 간단한 대화를 통해 워크플로를 자동화할 수 있도록 합니다!

라이선스 Discord 팔로우 Twitter 팔로우 GitHub 레포 스타 이슈

목차

프로젝트 아키텍처

아키텍처 다이어그램

Suna는 네 가지 주요 구성 요소로 이루어져 있습니다:

백엔드 API

Python/FastAPI 서비스로 REST 엔드포인트, 스레드 관리, Anthropic 및 기타 LiteLLM을 통한 LLM 통합을 처리합니다.

프론트엔드

Next.js/React 애플리케이션으로 채팅 인터페이스, 대시보드 등을 제공하는 반응형 UI를 제공합니다.

에이전트 Docker

모든 에이전트를 위한 격리된 실행 환경 - 브라우저 자동화, 코드 인터프리터, 파일 시스템 접근, 도구 통합 및 보안 기능을 포함합니다.

Supabase 데이터베이스

인증, 사용자 관리, 대화 기록, 파일 저장, 에이전트 상태, 분석 및 실시간 구독을 포함한 데이터 지속성을 처리합니다.

사용 사례

  1. 경쟁사 분석 (시청) - "영국의 헬스케어 산업에서 내 다음 회사를 위한 시장을 분석해 주세요. 주요 기업, 그들의 시장 규모, 강점 및 약점을 제공하고 웹사이트 URL을 추가해 주세요. 완료되면 PDF 보고서를 생성해 주세요."

  2. VC 리스트 (시청) - "자산 운용 규모를 기준으로 미국에서 가장 중요한 VC 펀드 목록을 제공해 주세요. 웹사이트 URL과 가능하면 연락할 이메일도 제공해 주세요."

  3. 후보자 찾기 (시청) - "LinkedIn에 가서 독일 뮌헨에 위치한 주니어 소프트웨어 엔지니어 직책을 위한 현재 일하지 않는 10개의 프로필을 찾아주세요. 컴퓨터 과학 또는 관련 분야의 학사 학위가 최소한 하나 이상 있고, 어떤 분야/역할에서든 1년의 경험이 있어야 합니다."

  4. 회사 여행 계획 (시청) - "회사를 위한 여행 경로 계획을 생성해 주세요. 캘리포니아로 갈 예정입니다. 8명이 참여합니다. 출발지(프랑스 파리)부터 활동까지 여행을 구성해 주세요. 여행은 7일 동안 진행될 예정이며, 출발은 2025년 4월 21일입니다. 다가오는 날씨 예보와 기온을 확인하고, 이를 바탕으로 활동(야외 vs 실내)을 계획해 주세요."

  5. 엑셀 작업 (시청) - "회사에서 이탈리아 복권 게임(Lotto, 10eLotto, Million Day)에 대한 모든 정보를 엑셀 스프레드시트로 설정하라고 요청했습니다. 이를 바탕으로 기본 정보(공개된 정보)가 포함된 스프레드시트를 생성하여 보내주세요."

  6. 이벤트 연사 탐색 자동화 (시청) - "지난 1년 동안 유럽에서 AI 윤리 연사로 컨퍼런스에서 발표한 20명을 찾아주세요. 컨퍼런스 사이트를 스크랩하고 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. 포럼 토론 스크랩 (시청) - "로마에서 최고의 미용 센터를 찾아야 하지만, 이 주제에 대해 이야기하는 오픈 포럼을 사용하여 찾고 싶습니다. Google에서 로마에 위치한 미용 센터 토론을 찾아 포럼을 스크랩해 주세요. 그런 다음 최고의 댓글이 있는 5개의 미용 센터 목록을 생성해 주세요."

셀프 호스팅

Suna는 설정 마법사를 사용하여 자체 인프라에서 셀프 호스팅할 수 있습니다. Suna를 셀프 호스팅하기 위한 포괄적인 가이드는 셀프 호스팅 가이드를 참조하세요.

설정 프로세스에는 다음이 포함됩니다:

  • 데이터베이스 및 인증을 위한 Supabase 프로젝트 설정
  • 캐싱 및 세션 관리를 위한 Redis 구성
  • 안전한 에이전트 실행을 위한 Daytona 설정
  • LLM 제공자(Anthropic, OpenAI, Groq 등)와의 통합
  • 웹 검색 및 스크랩 기능 구성

빠른 시작

  1. 저장소 복제:
git clone https://github.com/kortix-ai/suna.git
cd suna
  1. 설정 마법사 실행:
python setup.py
  1. 컨테이너 시작 또는 중지:
python start.py

수동 설정

자세한 수동 설정 지침은 셀프 호스팅 가이드를 참조하세요.

마법사는 Suna 인스턴스를 실행하는 데 필요한 모든 단계를 안내합니다. 자세한 지침, 문제 해결 팁 및 고급 구성 옵션은 셀프 호스팅 가이드를 참조하세요.

기여

커뮤니티의 기여를 환영합니다! 자세한 내용은 기여 가이드를 참조하세요.

감사의 말

주요 기여자

기술

라이선스

Kortix Suna는 Apache License, Version 2.0으로 라이선스됩니다. 전체 라이선스 텍스트는 LICENSE를 참조하세요.