A maioria dos frameworks de agentes para por aí: chat e chamadas de ferramenta. O CraftBot vai além: ele constrói, evolui e opera suas próprias ferramentas SaaS, e usa essa camada de ferramentas para se comunicar com você e automatizar tarefas.
Além disso, o CraftBot tem todas as capacidades essenciais de um framework de agente de uso geral. Ele executa tarefas como faria um funcionário remoto, lembra das suas preferências e objetivos, e te ajuda de forma proativa a planejar e agir naquilo que importa.
[](https://e2b.dev/startups)
## ✨ Principais recursos
Além de ser um agente de IA capaz de criar e operar suas próprias ferramentas SaaS, o CraftBot conta com todas as capacidades essenciais de um framework de agente, podendo atuar como um agente de IA de uso geral que te acompanha em suas tarefas, ferramentas, memória e fluxos de trabalho do dia a dia.
- **Perfis de agente** Mais de 40 perfis de agente (agente CEO, agente financeiro, agente líder de marketing, engenheiro DevOps, agente produtor de vídeo e mais 37) prontos para trabalhar por você. Encontre os papéis desejados em **[CraftBot Agent Bundles](https://github.com/CraftOS-dev/craftbot-agent-bundles)** e importe-os com um clique.
- **Catálogo de playbooks** Não sabe como automatizar com agente de IA? O CraftBot tem 120 playbooks prontos para uso (em 19 categorias). Abra o seletor de playbooks pela barra superior, escolha um playbook e ele começa a executar a tarefa por você.
- **Agent App.** Construa, importe ou evolua aplicações personalizadas que vivem dentro do CraftBot. O agente conhece o estado atual da UI o tempo todo e pode ler, escrever e agir sobre seus dados diretamente.
- **Multitarefa e roteamento de sessões.** Ainda digitando `/new` manualmente? O CraftBot decide quando abrir uma nova sessão e quando retomar uma tarefa, mantendo conversa e contexto unificados.
- **Self-hosted e BYOK.** Sistema flexível de provedores de LLM com suporte a OpenAI, Google Gemini, Anthropic Claude, OpenRouter e mais. Ou hospede seu próprio modelo gastando 0 tokens com o Ollama.
- **Sistema de memória.** Um segundo cérebro construído a partir das suas interações com o CraftBot. Abordagem híbrida: RAG + grafo de conhecimento + sistema de arquivos do agente. À meia-noite, o CraftBot "sonha" e consolida os eventos do dia.
- **Agente proativo.** Aprende suas preferências, hábitos e objetivos de vida. Em seguida, planeja e inicia tarefas (com sua aprovação, claro) para te ajudar a evoluir.
- **Integração com ferramentas externas.** Conecte-se aos seus apps como Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram e mais (e muito mais por vir!), com suporte a OAuth ou usando sua própria chave. Você pode conectar várias contas a cada integração.
- **Skills e MCP.** Mais de 150 MCPs e 170 Skills prontos para uso. Instalação rápida de novos Skills e MCPs. Crie ou melhore Skills a partir de tarefas concluídas com um clique.
- **Interface de navegador e suporte a CLI.** Use o CraftBot do jeito que melhor te servir: pela UI simples no navegador para o dia a dia, ou via CLI para scripts e ambientes headless.
---
## 🧰 Começando
Pré-requisitos: Python 3.10+ · Node.js 18+ para o modo navegador
```bash
# 1. Clone o repositório
git clone https://github.com/CraftOS-dev/CraftBot.git
cd CraftBot
# 2. Instale, registre o autoinício e inicie o CraftBot
python craftbot.py install
```
Pronto. O terminal se fecha sozinho, o CraftBot roda em segundo plano e o navegador abre automaticamente. Um **atalho na área de trabalho** é criado para que você possa reabrir o navegador quando quiser.
**Gerenciando o serviço após a instalação:**
```bash
python craftbot.py start # Inicia o CraftBot em segundo plano
python craftbot.py stop # Para o CraftBot
python craftbot.py restart # Reinicia o CraftBot
python craftbot.py status # Verifica se está rodando e se o autoinício está ativo
python craftbot.py logs # Exibe a saída recente dos logs
python craftbot.py uninstall # Para o serviço, remove o autoinício e desinstala os pacotes
```
> [!TIP]
> Depois de `install` ou `start`, um **atalho do CraftBot na área de trabalho** é criado automaticamente. Se você fechar o navegador, basta dar duplo clique no atalho para abri-lo de novo.
---
## 🌱 Agent App
**Agent App é um sistema/app/dashboard que evolui com suas necessidades.**
- Precisa de um quadro kanban com um copiloto de IA embutido?
- Um CRM sob medida, exatamente no formato do seu fluxo de trabalho?
- Um dashboard corporativo que o CraftBot consegue ler e operar por você?
Coloque-o no ar como uma Agent App que roda junto ao CraftBot e cresce conforme suas necessidades mudam.
### Três jeitos de criar uma Agent App
1. **Construir do zero.** Descreva em linguagem natural o que você quer. O CraftBot
monta o modelo de dados, a API de back-end e a UI em React, e itera com
você por um processo de design estruturado.
2. **Instalar pelo marketplace.** Explore as Agent Apps criadas pela comunidade em [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace).
3. **Importar um projeto existente.** Aponte o CraftBot para um projeto em Go, Node.js, Python,
Rust, ou um código-fonte estático ou repositório do GitHub. Ele detecta o runtime, configura health checks e empacota tudo como uma Agent App.
### Continua evoluindo com o CraftBot dentro do loop
Uma Agent App nunca está "pronta". Peça ao agente para adicionar funcionalidades,
redesenhar uma tela ou conectar a novos dados conforme suas necessidades crescem.
O CraftBot está embutido em toda Agent App e **conhece o estado dela**:
ele consegue ler o DOM atual e os valores dos formulários, consultar os dados da
app via API REST e disparar ações em seu nome.
### Mantém as ferramentas SaaS abertas e vivas
Construa, personalize e evolua sua própria Agent App, e dependa menos de ferramentas por assinatura que nunca foram feitas para encaixar perfeitamente nas suas necessidades.
---
# Três Agent Apps para experimentar em 5 minutos
- **📋 Quadro Kanban**: toda tarefa, follow-up e CTA em um único lugar. O CraftBot pode operá-lo e fazer o trabalho de PM por você.
- **📊 Habit Tracker**: crie e acompanhe seus hábitos. Calendário de atividades no estilo do GitHub para acompanhar seus hábitos como um(a) dev.
- **🐦 Luolinglo**: não é o Duolingo, mas você pode aprender novos idiomas, criar flashcards e praticar com o CraftBot.
**[Explore e contribua com o marketplace de Agent App →](https://craftos.net/marketplace)**
---
## 🔧 Solução de problemas e dúvidas comuns
### Falta o Node.js (para o modo navegador)
Se ao rodar `python run.py` você vir **"npm not found in PATH"**:
1. Baixe a versão LTS em [nodejs.org](https://nodejs.org/)
2. Instale e reinicie o terminal
3. Rode `python run.py` novamente
**Alternativa:** Use o modo CLI (sem necessidade de Node.js):
```bash
python run.py --cli
```
### A instalação falha por dependências
O instalador agora exibe mensagens detalhadas com possíveis soluções. Se a instalação falhar:
- **Verifique a versão do Python:** confirme que tem Python 3.10+ (`python --version`)
- **Verifique a internet:** as dependências são baixadas durante a instalação
- **Limpe o cache do pip:** rode `pip install --upgrade pip` e tente novamente
### Problemas na instalação do Playwright
A instalação do Chromium do Playwright é opcional. Se falhar:
- O agente **continua funcionando** para outras tarefas
- Você pode pular essa etapa e instalar depois com `playwright install chromium`
- Só é necessário para a integração com o WhatsApp Web
Para uma solução de problemas mais detalhada, veja [INSTALLATION_FIX.md](INSTALLATION_FIX.md).
---
## 🐳 Rodar com container
A raiz do repositório inclui uma configuração Docker com Python 3.10, pacotes de sistema essenciais (incluindo Tesseract para OCR) e todas as dependências Python definidas em `requirements.txt`, para que o agente rode de forma consistente em ambientes isolados.
Abaixo estão as instruções para rodar nosso agente em container.
### Construir a imagem
A partir da raiz do repositório:
```bash
docker build -t craftbot .
```
### Executar o container
A imagem está configurada para iniciar o agente com `python -m app.main` por padrão. Para rodar de forma interativa:
```bash
docker run --rm -it craftbot
```
Se precisar passar variáveis de ambiente, use um arquivo env (por exemplo, baseado em `.env.example`):
```bash
docker run --rm -it --env-file .env craftbot
```
Monte com `-v` os diretórios que precisam persistir fora do container (por exemplo, pastas de dados ou cache) e ajuste portas ou outras flags conforme seu deploy. A imagem traz dependências de sistema para OCR (`tesseract`) e clientes HTTP comuns, para o agente trabalhar com arquivos e APIs de rede dentro do container.
Por padrão, a imagem usa Python 3.10 e empacota as dependências Python de `requirements.txt`, então `python -m app.main` funciona de cara.
---
## 🤝 Como contribuir
PRs são bem-vindos! Confira o fluxo (fork → branch a partir de `dev` → PR) em [CONTRIBUTING.md](CONTRIBUTING.md). Todos os pull requests passam automaticamente por CI de lint + smoke test.
> [!IMPORTANT]
> O **CraftBot** está em desenvolvimento ativo, com melhorias toda semana. Se tiver dúvidas ou quiser uma conversa mais rápida, entre no nosso [Discord](https://discord.gg/ZN9YHc37HG) ou escreva para thamyikfoong(at)craftos.net.
---
## 🧾 Licença
Este projeto está sob a [Licença MIT](LICENSE). Você é livre para usar, hospedar e monetizar este projeto (em caso de distribuição e monetização, é necessário dar crédito a ele).
---
## ⭐ Agradecimentos
Desenvolvido e mantido por [CraftOS](https://craftos.net/) e contribuidores.
Se o **CraftBot** te for útil, dê uma ⭐ no repositório e compartilhe com outras pessoas!
---
## Histórico de stars
