azfarh95/sentinel-stack-public

O que sentinel-stack-public faz?

Sentinel AI Stack — assistente pessoal de IA auto-hospedado em hardware local, controlado via Telegram. MetaMCP + OpenClaw + Watchdog bot + servidores MCP.

Visão Geral

O Sentinel AI Stack fornece um assistente pessoal de IA completo, controlado via Telegram, executado inteiramente em seu próprio hardware. Ele combina:

• MetaMCP — Orquestração de modelos de IA (local ou API)
• OpenClaw — Funcionalidades avançadas para o assistente
• Watchdog Bot — Monitoramento e reinicialização automática
• Servidores MCP — Ferramentas modulares para o assistente (navegação na web, sistema de arquivos, etc.)

Pré-requisitos

• Docker e Docker Compose instalados
• Conta no Telegram e um bot token (via @BotFather)
• Hardware capaz de rodar modelos de IA localmente (GPU recomendada) ou acesso a uma API de modelo (OpenAI, Anthropic, etc.)

Instalação Rápida

1. Clone o repositório:

git clone https://github.com/azfarh95/sentinel-stack-public.git
cd sentinel-stack-public

2. Copie o arquivo de ambiente e configure:

cp .env.example .env

Edite o arquivo .env com suas configurações (token do Telegram, endpoint do modelo, etc.)

3. Inicie o stack:

docker-compose up -d

4. Envie /start para o seu bot no Telegram.

Configuração

Variáveis de Ambiente Principais

Variável	Descrição
TELEGRAM_BOT_TOKEN	Token do seu bot Telegram
MODEL_ENDPOINT	URL do modelo (local ou API)
MODEL_API_KEY	Chave da API (se aplicável)
MCP_SERVERS	Lista de servidores MCP a serem carregados

Servidores MCP

O Sentinel usa servidores MCP para funcionalidades. Você pode adicionar ou remover servidores no arquivo de configuração. Exemplos incluídos:

• mcp-web-search — Pesquisa na web
• mcp-file-system — Acesso ao sistema de arquivos local
• mcp-code-executor — Execução segura de código

Uso

• Chat: Envie uma mensagem para o bot e receba uma resposta do modelo.
• Comandos: Use /help para ver comandos disponíveis.
• Ferramentas: O assistente pode usar ferramentas MCP quando apropriado (ex.: "Pesquise na web sobre...").

Licença

Este projeto está licenciado sob a licença MIT — veja o arquivo LICENSE para detalhes.

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.