Repolode
TokenRhythm

TokenRhythm/opensquilla

Um agente de IA microkernel e econômico em tokens para CLI, Web UI e canais de chat, que encaminha cada turno ao modelo mais barato capaz de atendê-lo.

Alternativa open source a:ChatGPT

Estrelas
7,081
Forks
583
Issues abertas
271
Último commit
há 7 horas

O que é?

OpenSquilla é um agente de IA que roda localmente e se conecta a vários provedores de LLM. Um roteador local de modelos chamado SquillaRouter classifica cada turno com base em comprimento, idioma, código, palavras-chave e embeddings e, em seguida, o encaminha ao modelo mais barato capaz de atendê-lo. A classificação é feita no dispositivo, então o prompt não sai da máquina para essa decisão.

Web UI, CLI e canais de chat como Telegram, Slack, Discord, Feishu, DingTalk, WeCom, Matrix e QQ usam o mesmo loop de turnos, fazendo com que o despacho de ferramentas, as novas tentativas e os logs funcionem da mesma forma em todos eles. A memória persistente usa um arquivo MEMORY.md curado, além de busca de texto completo com SQLite e busca semântica com sqlite-vec; as ferramentas são isoladas em sandbox com Bubblewrap no Linux, Seatbelt no macOS ou um backend nativo no Windows.

O projeto também inclui skills sob demanda, suporte a cliente e servidor MCP, sessões com SQLite, um agendador no estilo cron e comandos de migração para importar estado do OpenClaw ou do Hermes Agent. Ele é distribuído como pacote Python, com instaladores para desktop no macOS e Windows.

Recursos principais

  • 01Encaminha cada turno ao modelo mais barato capaz de atendê-lo, usando um classificador local LightGBM e ONNX.
  • 02Oferece suporte a mais de 20 provedores de LLM, incluindo OpenAI, Anthropic, Ollama, OpenRouter e DeepSeek.
  • 03Oferece Web UI, CLI e canais de chat que compartilham um único loop de turnos.
  • 04Mantém memória local persistente, pesquisável por palavras-chave e embeddings semânticos.
  • 05Executa ferramentas em um sandbox em camadas, com os níveis de política Standard, Strict e Locked.
  • 06Inclui ferramentas integradas de busca na web, arquivos e shell, além de suporte a cliente e servidor MCP.

Casos de uso

  • Reduzir os gastos com APIs de LLM encaminhando solicitações simples a modelos mais baratos.
  • Executar um assistente pessoal auto-hospedado que responde por apps de chat como Telegram ou Slack.
  • Disponibilizar sessões do agente para outro cliente MCP em fluxos de trabalho automatizados.
  • Migrar configurações existentes do OpenClaw ou do Hermes Agent para um novo agente local.

Início rápido

  1. 1

    Instale o uv (Linux/macOS: execute o script oficial de instalação indicado no README)

  2. 2

    Instale o OpenSquilla com o uv a partir do wheel da versão lançada

    uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/TokenRhythm/opensquilla/releases/download/v0.5.6/opensquilla-0.5.6-py3-none-any.whl"
  3. 3

    Configure o OpenSquilla

    opensquilla onboard
  4. 4

    Inicie o gateway

    opensquilla gateway run

Antes de usar

  • A instalação padrão inclui dependências pesadas do roteador, como ONNX Runtime e LightGBM; por isso, a primeira instalação exige um download considerável.
  • No Windows e no macOS, o roteador pode precisar de bibliotecas nativas do sistema, como Visual C++ Redistributable ou libomp, que não são fornecidas pela instalação rápida no terminal.
  • Para compilar a partir do código-fonte, é necessário ter Git LFS e Node.js 22.12 ou superior com npm.

Em coleções

Tópicos

Perguntas frequentes

O que é opensquilla?
Um agente de IA microkernel e econômico em tokens para CLI, Web UI e canais de chat, que encaminha cada turno ao modelo mais barato capaz de atendê-lo. OpenSquilla é um agente de IA que roda localmente e se conecta a vários provedores de LLM. Um roteador local de modelos chamado SquillaRouter classifica cada turno com base em comprimento, idioma, código, palavras-chave e embeddings e, em seguida, o encaminha ao modelo mais barato capaz de atendê-lo. A classificação é feita no dispositivo, então o prompt não sai da máquina para essa decisão.
opensquilla é gratuito? Qual é a licença?
opensquilla é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
opensquilla ainda é mantido?
Manutenção ativa. O último commit de opensquilla foi em 22 de out. de 2026.
Para que posso usar opensquilla?
Reduzir os gastos com APIs de LLM encaminhando solicitações simples a modelos mais baratos. Executar um assistente pessoal auto-hospedado que responde por apps de chat como Telegram ou Slack. Disponibilizar sessões do agente para outro cliente MCP em fluxos de trabalho automatizados. Migrar configurações existentes do OpenClaw ou do Hermes Agent para um novo agente local.
Como instalar opensquilla?
Instale o uv (Linux/macOS: execute o script oficial de instalação indicado no README) Instale o OpenSquilla com o uv a partir do wheel da versão lançada: uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/TokenRhythm/opensquilla/releases/download/v0.5.6/opensquilla-0.5.6-py3-none-any.whl" Configure o OpenSquilla: opensquilla onboard Inicie o gateway: opensquilla gateway run
Onde consigo opensquilla?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/TokenRhythm/opensquilla

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados