Introdução

O OpenManus é uma alternativa de código aberto ao Manus que ganhou rapidamente popularidade na comunidade de desenvolvedores. Esta ferramenta permite executar agentes de IA diretamente na sua máquina, sem custos de API e sem dependência de serviços externos. O melhor de tudo: você pode conectar modelos de linguagem locais através do Ollama.

Requisitos Prévios

• Python 3.12
• Conda (ou uv para usuários macOS)
• Olama instalado localmente

Método 1: Instalação via Conda (Recomendado para Windows)

Passo 1: Criar Ambiente Virtual

conda create -n agent_local python=3.12
conda activate agent_local

Passo 2: Clonar Repositório

git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

Passo 3: Instalar Dependências

pip install -r requirements.txt

Passo 4: Configurar Ollama

Instale o Ollama através do site oficial. Para função de chamada (function calling), utilize modelos compatíveis como:

# Modelo principal
ollama run qwen2.5-coder:14b

# Modelo de visão (opcional)
ollama run minicpm-v

Passo 5: Configurar Arquivo TOML

Navegue até OpenManus\config\config.example.toml e renomeie para config.toml. Ajuste o conteúdo:

[llm]
model = "qwen2.5-coder:14b"
base_url = "http://localhost:11434/v1"
api_key = "sk-local"
max_tokens = 4096
temperature = 0.0

[llm.vision]
model = "qwen2.5-coder:14b"
base_url = "http://localhost:11434/v1"
api_key = "sk-local"

Passo 6: Executar Aplicação

python main.py

Comandos para Execução Posterior

conda activate agent_local
cd OpenManus
python main.py

Método 2: Instalação via uv (Recomendado para macOS)

Passo 1: Instalar uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Passo 2: Clonar Repositório

git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

Passo 3: Criar e Ativar Ambiente Virtual

# Windows
uv venv
.venv\Scripts\activate

# macOS/Linux
uv venv
source .venv/bin/activate

Passo 4: Instalar Dependências

uv pip install -r requirements.txt

Passo 5: Configurar Ollama

Execute os modelos conforme mostrado no Método 1.

Gerenciamento de Modelos

Para verificar e remover modelos instalados:

# Listar modelos instalados
ollama list

# Remover modelo específico
ollama rm nome_do_modelo

Considerações Importantes

• O modelo utilizado deve suportar function calling para que o OpenManus funcione corretamente
• A configuração da URL deve apontar para http://localhost:11434/v1
• A chave API pode ser qualquer valor para uso local (o Ollama não valida chaves localmente)
• Modelos de visão são opcionais mas recomendados para tarefas de análise de imagens

Conclusão

Com esta configuração, você terá um agente de IA completamente funcional rodando localmente, sem custos de API e com privaciadde total dos seus dados. A integração com Ollama permite flexibilidade na escolha de modelos conforme suas necessidades específicas.