Содержание

• Архитектура Suna
  • Backend API
  • Frontend
  • Agent Docker
  • База данных Supabase
• Примеры использования
• Самостоятельное развертывание
• Благодарности
• Лицензия

Архитектура проекта

Suna состоит из четырех основных компонентов:

Backend API

Сервис на Python/FastAPI, обрабатывающий REST-эндпоинты, управление потоками и интеграцию с LLM (Anthropic и другими через LiteLLM).

Frontend

Next.js/React приложение с адаптивным интерфейсом: чат, дашборд и другие элементы.

Agent Docker

Изолированная среда выполнения для каждого агента — с автоматизацией браузера, интерпретатором кода, доступом к файловой системе, интеграцией инструментов и функциями безопасности.

База данных Supabase

Обеспечивает хранение данных с аутентификацией, управлением пользователями, историей диалогов, хранением файлов, состоянием агентов, аналитикой и подписками в реальном времени.

Примеры использования

1. Анализ конкурентов (Смотреть) — "Проанализируй рынок для моей новой компании в сфере здравоохранения в Великобритании. Укажи основных игроков, их долю рынка, сильные и слабые стороны, добавь ссылки на их сайты. Затем создай PDF-отчет."

2. Список венчурных фондов (Смотреть) — "Предоставь список самых важных венчурных фондов в США по объему активов под управлением. Укажи ссылки на их сайты и, если возможно, контактные email."

3. Поиск кандидатов (Смотреть) — "Найди на LinkedIn 10 профилей доступных (не работающих в данный момент) кандидатов на позицию junior software engineer из Мюнхена (Германия). У них должно быть как минимум одно высшее образование в области Computer Science или смежных дисциплин и 1 год опыта в любой сфере/роли."

4. Планирование корпоративной поездки (Смотреть) — "Составь план поездки для моей компании в Калифорнию. Нас будет 8 человек. Включи маршрут от вылета (Париж, Франция) до мероприятий с учетом 7-дневной поездки (выезд 21 апреля 2025). Проверь прогноз погоды и температуру на эти дни и спланируй мероприятия (на открытом воздухе или в помещении)."

5. Работа с Excel (Смотреть) — "Моя компания попросила создать таблицу Excel с информацией об итальянских лотереях (Lotto, 10eLotto и Million Day). На основе этого сформируй и отправь мне таблицу с базовой информацией (из открытых источников)."

6. Автоматизация поиска спикеров для мероприятий (Смотреть) — "Найди 20 спикеров по этике ИИ из Европы, выступавших на конференциях за последний год. Просканируй сайты конференций, перекрестно проверь LinkedIn и YouTube, предоставь контакты и краткое содержание выступлений."

7. Суммаризация и перекрестный анализ научных статей (Смотреть) — "Исследуй и сравни научные статьи об эффектах алкоголя на организм за последние 5 лет. Создай отчет о самых важных работах по этой теме."

8. Исследование + черновик первого контакта (Смотреть) — "Найди моих потенциальных клиентов (B2B) в clean tech индустрии на LinkedIn. Определи их сайты и email. Затем на основе профиля компании создай персонализированное письмо для первого контакта, где я представлю свою компанию, предлагающую консалтинговые услуги для cleantech-компаний по максимизации прибыли и снижению затрат."

9. SEO-анализ (Смотреть) — "На основе моего сайта suna.so проведи SEO-анализ, найди страницы с высоким рейтингом по кластерам ключевых слов и определи недостающие темы."

10. Планирование личной поездки (Смотреть) — "Спланируй личную поездку в Лондон с вылетом из Бангкока 1 мая на 10 дней. Найди жилье в центре Лондона с рейтингом Google не ниже 4.5. Подбери интересные мероприятия на открытом воздухе. Создай детальный маршрут."

11. Недавно финансируемые стартапы (Смотреть) — "Проверь Crunchbase, Dealroom и TechCrunch на предмет раундов финансирования Series A в сфере SaaS Finance. Создай отчет с данными о компаниях, основателях и контактами для исходящих продаж."

12. Скрапинг форумов (Смотреть) — "Мне нужно найти лучшие косметические центры в Риме через открытые форумы. Найди в Google обсуждения косметических центров в Риме и составь список из 5 центров с лучшими отзывами."

Самостоятельное развертывание

Suna можно развернуть на собственной инфраструктуре с помощью нашего мастера настройки. Подробное руководство доступно в Self-Hosting Guide.

Процесс включает:

• Настройку проекта Supabase для базы данных и аутентификации
• Конфигурацию Redis для кэширования и управления сессиями
• Настройку Daytona для безопасного выполнения агентов
• Интеграцию с провайдерами LLM (Anthropic, OpenAI, Groq и др.)
• Настройку веб-поиска и скрапинга

Быстрый старт

1. Клонируйте репозиторий:

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

2. Запустите мастер настройки:

python setup.py

3. Запуск/остановка контейнеров:

python start.py

Ручная настройка

Подробные инструкции доступны в Self-Hosting Guide.

Мастер проведет вас через все необходимые шаги для запуска вашего экземпляра Suna. Для детальных инструкций, советов по устранению неполадок и расширенных настроек см. Self-Hosting Guide.

Участие в проекте

Мы приветствуем вклад сообщества! Подробности в Contributing Guide.

Благодарности

Основные участники

• Adam Cohen Hillel
• Dat-lequoc
• Marko Kraemer

Технологии

• Daytona — Безопасная среда выполнения агентов
• Supabase — База данных и аутентификация
• Playwright — Автоматизация браузера
• OpenAI — Провайдер LLM
• Anthropic — Провайдер LLM
• Tavily — Возможности поиска
• Firecrawl — Возможности веб-скрапинга
• RapidAPI — API-сервисы

Лицензия

Kortix Suna распространяется под лицензией Apache License, Version 2.0. Полный текст лицензии доступен в LICENSE.