Suna - Agente de IA Generalista de Código Aberto

(que age em seu nome)

Suna é um assistente de IA totalmente open source que ajuda você a realizar tarefas do mundo real com facilidade. Através de conversas naturais, Suna se torna seu companheiro digital para pesquisa, análise de dados e desafios cotidianos — combinando capacidades poderosas com uma interface intuitiva que entende suas necessidades e entrega resultados.

O kit de ferramentas avançado da Suna inclui automação de navegador para navegar na web e extrair dados, gerenciamento de arquivos para criação e edição de documentos, web crawling e capacidades de busca estendida, execução de linha de comando para tarefas de sistema, implantação de websites e integração com diversas APIs e serviços. Essas capacidades trabalham em harmonia, permitindo que a Suna resolva seus problemas complexos e automatize fluxos de trabalho através de conversas simples!

Arquitetura do Projeto

Diagrama de Arquitetura

A Suna consiste em quatro componentes principais:

Backend API

Serviço Python/FastAPI que gerencia endpoints REST, gerenciamento de threads e integração com LLMs como Anthropic e outros via LiteLLM.

Frontend

Aplicação Next.js/React que fornece uma UI responsiva com interface de chat, dashboard, etc.

Agent Docker

Ambiente de execução isolado para cada agente - com automação de navegador, interpretador de código, acesso ao sistema de arquivos, integração de ferramentas e recursos de segurança.

Supabase Database

Gerencia persistência de dados com autenticação, gerenciamento de usuários, histórico de conversas, armazenamento de arquivos, estado do agente, análises e assinaturas em tempo real.

Casos de Uso

Análise de Concorrentes (Assista) - "Analise o mercado para minha próxima empresa no setor de saúde, localizada no Reino Unido. Liste os principais players, seu tamanho de mercado, pontos fortes e fracos, e adicione os URLs de seus sites. Ao final, gere um relatório em PDF."
Lista de VCs (Assista) - "Forneça uma lista dos fundos de VC mais importantes nos EUA baseados em Assets Under Management. Inclua URLs de sites e, se possível, e-mails para contato."
Busca por Candidatos (Assista) - "Acesse o LinkedIn e encontre 10 perfis disponíveis - que não estão empregados atualmente - para uma vaga de engenheiro de software júnior, localizados em Munique, Alemanha. Devem ter pelo menos um bacharelado em Ciência da Computação ou área relacionada, e 1 ano de experiência em qualquer campo/cargo."
Planejamento de Viagem Corporativa (Assista) - "Gere um plano de roteiro para minha empresa. Iremos para a Califórnia. Seremos 8 pessoas. Monte a viagem desde a partida (Paris, França) até as atividades que podemos fazer considerando que a viagem durará 7 dias - partida em 21 de abril de 2025. Verifique a previsão do tempo e temperatura para os próximos dias e, com base nisso, planeje nossas atividades (ao ar livre vs. indoor)."
Trabalhando com Excel (Assista) - "Minha empresa me pediu para criar uma planilha Excel com todas as informações sobre os jogos de loteria italianos (Lotto, 10eLotto e Million Day). Com base nisso, gere e envie-me uma planilha com todas as informações básicas (públicas)."
Automatizar Prospecção de Palestrantes para Eventos (Assista) - "Encontre 20 palestrantes de ética em IA da Europa que falaram em conferências no último ano. Raspagem de sites de conferências, cruzamento com LinkedIn e YouTube, e saída com informações de contato + resumos das palestras."
Resumir e Cruzar Referências de Artigos Científicos (Assista) - "Pesquise e compare artigos científicos sobre os efeitos do Álcool em nossos corpos nos últimos 5 anos. Gere um relatório sobre os artigos científicos mais importantes que abordam o tópico mencionado."
Pesquisa + Rascunho de Primeiro Contato (Assista) - "Pesquise meus clientes potenciais (B2B) no LinkedIn. Devem estar no setor de clean tech. Encontre seus sites e e-mails. Depois, com base no perfil da empresa, gere um e-mail de primeiro contato personalizado onde apresento minha empresa que oferece serviços de consultoria para empresas de clean tech para maximizar seus lucros e reduzir custos."
Análise SEO (Assista) - "Com base no meu site suna.so, gere uma análise de relatório SEO, encontre páginas com melhor rankeamento por clusters de palavras-chave e identifique tópicos que estou perdendo."
Gerar uma Viagem Pessoal (Assista) - "Gere uma viagem pessoal para Londres, com partida de Bangkok em 1º de maio. A viagem durará 10 dias. Encontre uma acomodação no centro de Londres, com avaliação no Google de pelo menos 4.5. Encontre atividades interessantes ao ar livre para fazer durante a viagem. Gere um plano de itinerário detalhado."
Startups Recentemente Financiadas (Assista) - "Acesse Crunchbase, Dealroom e TechCrunch, filtre por rodadas de financiamento Série A no setor de SaaS Finance e construa um relatório com dados das empresas, fundadores e informações de contato para vendas outbound."
Raspar Discussões em Fóruns (Assista) - "Preciso encontrar os melhores centros de beleza em Roma, mas quero encontrá-los usando fóruns abertos que discutam esse tópico. Acesse o Google e raspe fóruns procurando discussões sobre centros de beleza em Roma. Então gere uma lista de 5 centros de beleza com os melhores comentários sobre eles."

Auto-hospedagem

A Suna pode ser auto-hospedada em sua própria infraestrutura usando nosso assistente de configuração. Para um guia completo sobre auto-hospedagem da Suna, consulte nosso Guia de Auto-hospedagem.

O processo de configuração inclui:

Configurar um projeto Supabase para banco de dados e autenticação
Configurar Redis para cache e gerenciamento de sessão
Configurar Daytona para execução segura de agentes
Integração com provedores de LLM (Anthropic, OpenAI, Groq, etc.)
Configurar capacidades de busca na web e raspagem

Início Rápido

Clone o repositório:

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

Execute o assistente de configuração:

python setup.py

Inicie ou pare os containers:

python start.py

Configuração Manual

Consulte o Guia de Auto-hospedagem para instruções detalhadas de configuração manual.

O assistente guiará você por todas as etapas necessárias para colocar sua instância da Suna em funcionamento. Para instruções detalhadas, dicas de solução de problemas e opções avançadas de configuração, consulte o Guia de Auto-hospedagem.

Contribuindo

Aceitamos contribuições da comunidade! Consulte nosso Guia de Contribuição para mais detalhes.

Agradecimentos

Principais Contribuidores

Tecnologias

Daytona - Ambiente seguro de execução de agentes
Supabase - Banco de dados e autenticação
Playwright - Automação de navegador
OpenAI - Provedor de LLM
Anthropic - Provedor de LLM
Tavily - Capacidades de busca
Firecrawl - Capacidades de raspagem web
RapidAPI - Serviços de API

Licença

Kortix Suna está licenciado sob a Licença Apache, Versão 2.0. Consulte LICENSE para o texto completo da licença.