
Um assistente pessoal de IA com foco em segurança.

Stavrobot é um assistente pessoal de IA construído com o princípio de "todo o acesso que um assistente de IA precisa, e nada mais".
Ele tem todos os recursos interessantes de um assistente de IA, mas foca em sandboxing, isolamento e permissões mínimas. É leve e é implantado apenas com um docker compose up.
uv, isolado do ambiente host.Instalação assistida por IA: Peça à sua IA de programação (Claude Code, Cursor, Windsurf, etc.) para buscar e seguir https://stavrobot.stavros.io/INSTALL.md — ela guiará você por toda a configuração de forma interativa.
Instalação manual:
Envie uma mensagem para @BotFather no Telegram para criar um bot e copie o token. Envie uma mensagem para @userinfobot para obter seu ID de usuário do Telegram (este é usado como o chat ID).
Copie env.example para .env e altere POSTGRES_PASSWORD para algo seguro e TZ para o seu fuso horário.
Copie config.example.toml para data/main/config.toml e preencha os campos obrigatórios: apiKey, password, publicHostname, [owner].name, [owner].telegram (seu chat ID) e [telegram].botToken. Todo o resto no arquivo é opcional.
docker compose up --build
É isso. Envie uma mensagem para seu bot no Telegram e ele responderá. Consulte as seções detalhadas de configuração abaixo para Signal, WhatsApp, email e outras opções.
config.example.toml para data/main/config.toml.authFile (ou apiKey) e publicHostname. Todo o resto é opcional.env.example para .env e defina seu fuso horário (TZ). Credenciais do Postgres e outras configurações de ambiente também podem ser sobrescritas ali. Sempre defina POSTGRES_PASSWORD para algo seguro — o padrão é um placeholder fraco e não deve ser usado em produção.Após o aplicativo iniciar, abra /settings/config para editar config.toml no navegador. A página é protegida por HTTP Basic Auth e exibe a configuração bruta, incluindo quaisquer segredos que ela contenha. Uma gravação válida cria um único backup <CONFIG_PATH>.bak, salva o novo conteúdo e reinicia o aplicativo; isso interrompe qualquer turno do agente em andamento.
plugin-runner, coder, signal-bridge e python-runner leem config.toml apenas
quando iniciam. Alterações que os afetam, como a palavra-passe, exigem reiniciar
manualmente esses contentores.
O Stavrobot pode ser apontado para qualquer endpoint compatível com OpenAI (Ollama, LiteLLM, vLLM, etc.) ou para um proxy personalizado compatível com Anthropic, definindo baseUrl em config.toml. Consulte config.example.toml para os campos obrigatórios e exemplos de configuração. Defina reasoning = true apenas para modelos que suportam thinking, pois é isso que faz com que thinkingLevel se aplique num endpoint personalizado.
A aplicação suporta dois modos de autenticação: chave de API ou OAuth.
apiKey em config.toml. Não é necessário iniciar nem terminar sessão.authFile em config.toml (um caminho onde as credenciais serão armazenadas). A página de início de sessão funciona com qualquer fornecedor OAuth suportado pelo Pi.
<your-hostname>/login num navegador. Siga as instruções na página e as credenciais são guardadas no ficheiro de autenticação. O Stavrobot escolhe o método de início de sessão headless do fornecedor, pelo que nunca é redirecionado para um callback localhost inacessível. Com a Anthropic, depois de selecionar Authorize, a Anthropic mostra um código, que deve copiar e colar na página de início de sessão do Stavrobot. Os fornecedores com um fluxo de código de dispositivo mostram o código na página do Stavrobot, em vez disso, e deve introduzi-lo no site do fornecedor. Se a autenticação expirar enquanto o bot estiver em execução, este envia-lhe uma mensagem com o URL de início de sessão através da sua plataforma de mensagens.authFile. O bot deteta a ausência de credenciais na mensagem seguinte e pede-lhe para iniciar sessão novamente.O contentor coder é opcional (necessário apenas para a funcionalidade de auto-programação). Por predefinição, utiliza o Claude Code com autenticação por subscrição (OAuth), separada da chave de API da aplicação principal. Para utilizar um endpoint de API compatível com Anthropic, defina tanto [coder].apiKey como [coder].baseUrl em config.toml; o Claude Code utiliza-os então como ANTHROPIC_API_KEY e ANTHROPIC_BASE_URL. O apiKey/baseUrl de nível superior apenas configuram o modelo da aplicação principal e nunca afetam o coder. Definir apenas uma das duas chaves [coder] é um erro de arranque.
Os perfis do Docker Compose são separados por vírgulas, pelo que pode combiná-los (por exemplo, COMPOSE_PROFILES=signal,coder).
COMPOSE_PROFILES no seu ficheiro .env para incluir coder (por exemplo, COMPOSE_PROFILES=coder, ou COMPOSE_PROFILES=signal,coder se também estiver a utilizar o Signal).docker compose --profile coder up --build[coder].apiKey/[coder].baseUrl): docker compose exec -u coder coder claude (ser-lhe-á pedido para iniciar sessão se ainda não o tiver feito).[coder].model na sua configuração com um alias de modelo do Claude Code (sonnet, opus ou haiku).O Signal requer um número de telefone separado — não o seu pessoal. Um SIM pré-pago ou um número VoIP funciona.