Suna - Assistente de IA Generalista de Código Aberto

(que age em seu nome)

Suna é um assistente de IA totalmente aberto 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 do Suna inclui automação de navegação na web para extrair dados, gerenciamento de arquivos para criação e edição de documentos, capacidades estendidas de web crawling e busca, execução de comandos no terminal para tarefas de sistema, implantação de websites e integração com diversas APIs e serviços. Essas funcionalidades trabalham em harmonia, permitindo que o Suna resolva seus problemas complexos e automatize fluxos de trabalho através de conversas simples!

Arquitetura do Projeto

Diagrama de Arquitetura

Suna é composto por quatro componentes principais:

API Backend

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 interface responsiva com chat, dashboard, etc.

Docker do Agente

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.

Banco de Dados Supabase

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 (Assistir) - "Analise o mercado para minha próxima empresa no setor de saúde, localizada no Reino Unido. Forneça os principais players, seu tamanho de mercado, pontos fortes e fracos, e inclua os URLs de seus sites. Ao final, gere um relatório em PDF."
Lista de VCs (Assistir) - "Forneça uma lista dos fundos de Venture Capital mais importantes nos Estados Unidos, baseado em Assets Under Management. Inclua URLs de sites e, se possível, e-mails para contato."
Busca por Candidatos (Assistir) - "Acesse o LinkedIn e encontre 10 perfis disponíveis - que não estão empregados no momento - para uma vaga de engenheiro de software júnior em Munique, Alemanha. Eles devem ter pelo menos um bacharelado em Ciência da Computação ou área relacionada, e 1 ano de experiência em qualquer função."
Planejamento de Viagem Corporativa (Assistir) - "Gere um plano de roteiro para minha empresa. Iremos para a Califórnia, em um grupo de 8 pessoas. Elabore a viagem desde a partida (Paris, França) até as atividades, considerando uma duração de 7 dias - saída em 21 de abril de 2025. Verifique a previsão do tempo e temperatura para os dias da viagem e planeje atividades (ao ar livre ou internas) com base nisso."
Trabalhando com Excel (Assistir) - "Minha empresa pediu para criar uma planilha Excel com informações sobre loterias italianas (Lotto, 10eLotto e Million Day). Gere e envie uma planilha com todos os dados básicos (públicos)."
Automatizar Prospecção de Palestrantes para Eventos (Assistir) - "Encontre 20 palestrantes sobre ética em IA da Europa que tenham falado em conferências no último ano. Faça scraping de sites de eventos, cruze dados com LinkedIn e YouTube, e forneça informações de contato + resumos das palestras."
Resumir e Cruzar Artigos Científicos (Assistir) - "Pesquise e compare artigos científicos dos últimos 5 anos sobre os efeitos do álcool no corpo humano. Gere um relatório com os artigos mais relevantes sobre o tema."
Pesquisa + Rascunho de Primeiro Contato (Assistir) - "Pesquise clientes potenciais (B2B) no LinkedIn no setor de cleantech. Encontre sites e e-mails. Depois, com base no perfil da empresa, gere um e-mail personalizado de primeiro contato apresentando minha empresa, que oferece consultoria para maximizar lucros e reduzir custos em cleantech."
Análise SEO (Assistir) - "Com base no meu site suna.so, gere uma análise de SEO, identifique páginas com melhor rankeamento por clusters de palavras-chave e temas ausentes."
Gerar uma Viagem Pessoal (Assistir) - "Gere uma viagem pessoal para Londres, com partida de Bangcoc em 1º de maio, durando 10 dias. Encontre uma hospedagem no centro de Londres com avaliação mínima de 4.5 no Google. Sugira atividades ao ar livre e um itinerário detalhado."
Startups Recentemente Financiadas (Assistir) - "Acesse Crunchbase, Dealroom e TechCrunch, filtre por rodadas Series A no setor de SaaS Finance, e crie um relatório com dados das empresas, fundadores e contatos para vendas outbound."
Raspagem de Discussões em Fóruns (Assistir) - "Preciso encontrar os melhores centros de beleza em Roma usando fóruns abertos sobre o tema. Faça scraping no Google de discussões sobre centros de beleza em Roma e gere uma lista dos 5 melhores com base nos comentários."

Hospedagem Própria

O Suna pode ser hospedado em sua própria infraestrutura usando nosso assistente de configuração abrangente. Para um guia completo sobre como hospedar o Suna, consulte nosso Guia de Hospedagem Própria.

O processo de configuração inclui:

Configuração de um projeto Supabase para banco de dados e autenticação
Configuração do Redis para cache e gerenciamento de sessões
Configuração do Daytona para execução segura de agentes
Integração com provedores de LLM (Anthropic, OpenAI, OpenRouter, etc.)
Configuração de busca na web e recursos de scraping (Tavily, Firecrawl)
Configuração do QStash para processamento de tarefas em segundo plano e fluxos de trabalho
Configuração de tratamento de webhooks para tarefas automatizadas
Integrações opcionais (RapidAPI, Smithery para agentes personalizados)

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

O assistente irá guiá-lo por 14 etapas com salvamento de progresso, permitindo que você retome caso seja interrompido.

Inicie ou pare os containers:

python start.py

Configuração Manual

Consulte o Guia de Hospedagem Própria para instruções detalhadas de configuração manual.

O assistente irá guiá-lo por todas as etapas necessárias para colocar sua instância do 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 Hospedagem Própria.

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 pesquisa
Firecrawl - Capacidades de raspagem web
QStash - Processamento de tarefas em segundo plano e fluxos de trabalho
RapidAPI - Serviços de API
Smithery - Desenvolvimento de agentes personalizados

Licença

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