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

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

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

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

프로젝트 아키텍처

아키텍처 다이어그램

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

백엔드 API

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

프론트엔드

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

에이전트 도커

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

Supabase 데이터베이스

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

사용 사례

경쟁사 분석 (보기) - "영국 헬스케어 산업에서 다음 회사를 위한 시장 분석을 해주세요. 주요 기업, 시장 규모, 강점과 약점을 알려주고 웹사이트 URL을 추가해주세요. 완료 후 PDF 보고서를 생성해주세요."
VC 리스트 (보기) - "미국에서 자산 규모 기준 가장 중요한 벤처 캐피탈(VC) 펀드 목록을 제공해주세요. 웹사이트 URL과 가능하면 연락 이메일도 포함해주세요."
후보자 찾기 (보기) - "LinkedIn에서 독일 뮌헨에 위치한 주니어 소프트웨어 엔지니어 직무에 지원 가능한(현재 근무 중이 아닌) 프로필 10개를 찾아주세요. 컴퓨터 공학 또는 관련 분야 학사 학위와 1년 이상의 경력(분야/역할 무관)이 있어야 합니다."
회사 출장 계획 (보기) - "캘리포니아로 갈 8명 규모의 회사 출장 계획을 세워주세요. 출발지(프랑스 파리)부터 7일간의 활동까지 구성해주세요. 출발일은 2025년 4월 21일입니다. 일기 예보와 기온을 확인하여 실내/야외 활동을 계획해주세요."
엑셀 작업 (보기) - "이탈리아 복권 게임(Lotto, 10eLotto, Million Day)에 대한 모든 공개 정보를 포함한 엑셀 스프레드시트를 생성해주세요."
이벤트 연사 발굴 자동화 (보기) - "유럽에서 지난 1년간 컨퍼런스에서 발표한 AI 윤리 연사 20명을 찾아주세요. 컨퍼런스 사이트, LinkedIn, YouTube를 크롤링하여 연락처와 발표 요약을 제공해주세요."
과학 논문 요약 및 비교 (보기) - "최근 5년간 알코올이 인체에 미치는 영향에 관한 과학 논문을 연구하고 비교해주세요. 해당 주제의 주요 논문을 요약한 보고서를 생성해주세요."
리서치 + 첫 연락 초안 (보기) - "LinkedIn에서 클린 테크 산업의 잠재 고객(B2B)을 조사해주세요. 웹사이트와 이메일 주소를 찾은 후, 회사 프로필에 기반해 맞춤형 첫 연락 이메일을 작성해주세요. 우리 회사는 클린 테크 기업의 수익 극대화와 비용 절감을 위한 컨설팅 서비스를 제공합니다."
SEO 분석 (보기) - "suna.so 웹사이트 기반으로 SEO 분석 보고서를 생성해주세요. 키워드 클러스터별 상위 랭킹 페이지와 누락된 주제를 식별해주세요."
개인 여행 계획 (보기) - "방콕 출발(5월 1일) 10일간의 런던 개인 여행 계획을 세워주세요. 구글 리뷰 4.5 이상의 중심부 숙소와 흥미로운 야외 활동을 포함한 상세 일정을 만들어주세요."
최근 투자 받은 스타트업 (보기) - "Crunchbase, Dealroom, TechCrunch에서 SaaS 금융 분야 Series A 투자 받은 스타트업을 조사해 회사 데이터, 창립자, 아웃바운드 영업용 연락처가 포함된 보고서를 생성해주세요."
포럼 토론 스크래핑 (보기) - "로마의 최고 미용 센터 5곳을 포럼 토론을 통해 찾아주세요. 구글에서 로마 미용 센터 관련 포럼을 크롤링하여 긍정적인 평가가 많은 곳을 선정해주세요."

셀프 호스팅

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

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

데이터베이스 및 인증을 위한 Supabase 프로젝트 설정
캐싱 및 세션 관리를 위한 Redis 구성
안전한 에이전트 실행을 위한 Daytona 설정
LLM 제공자와의 통합 (Anthropic, OpenAI, OpenRouter 등)
웹 검색 및 스크래핑 기능 구성 (Tavily, Firecrawl)
백그라운드 작업 처리 및 워크플로우를 위한 QStash 설정
자동화된 작업을 위한 웹훅 처리 구성
선택적 통합 (RapidAPI, 커스텀 에이전트를 위한 Smithery)

빠른 시작

저장소 복제:

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

설정 마법사 실행:

python setup.py

마법사는 진행 상황 저장 기능이 있는 14단계로 안내하며, 중단된 경우 재개할 수 있습니다.

컨테이너 시작 또는 중지:

python start.py

수동 설정

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

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

기여하기

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

감사의 말

주요 기여자

기술 스택

Daytona - 안전한 에이전트 실행 환경
Supabase - 데이터베이스 및 인증 서비스
Playwright - 브라우저 자동화 도구
OpenAI - LLM 제공업체
Anthropic - LLM 제공업체
Tavily - 검색 기능 제공
Firecrawl - 웹 스크래핑 기능 제공
QStash - 백그라운드 작업 처리 및 워크플로우 관리
RapidAPI - API 서비스 제공
Smithery - 커스텀 에이전트 개발 플랫폼

라이선스

Kortix Suna는 Apache License, Version 2.0에 따라 라이선스가 부여됩니다. 전체 라이선스 텍스트는 LICENSE에서 확인하실 수 있습니다.