FreeLLMAPI
tashfeenahmed/freellmapiRevisado por IA
O que faz
O FreeLLMAPI roda um pequeno servidor no seu computador que reúne os planos gratuitos que você já tem com provedores como Google, Groq, Cerebras e OpenRouter. Você cola cada chave uma vez no painel; seus programas então usam um único endereço local com uma única chave, e o sistema escolhe um modelo que ainda tenha cota e passa para o próximo quando um provedor recusa. Funciona com clientes no estilo OpenAI, Anthropic, Gemini e Ollama, incluindo Claude Code e Cursor. Há instaladores de desktop, apps para celular e Docker. O autor descreve o projeto como apenas para experimentação pessoal.
Facilidade de instalação
B · instalador e um ajuste simples · Windows
- Windows B
- macOS B
- Linux B
Windows é o mais fácil: o FreeLLMAPI-Setup .exe da página de releases, que o README chama de caminho mais fácil, e o app de desktop não pede conta nem senha. O macOS tem um .dmg que parece assinado para Apple Silicon e Intel, e o Linux tem AppImage, .deb e .rpm. É um B porque nada funciona até você se cadastrar nos provedores e colar as chaves na página Keys. O caminho pelo servidor (script de uma linha, Docker Compose) precisa do Docker e é mais difícil.
Números no GitHub
- Estrelas
- 45.200em 31 de out. de 2026
- Downloads
- 396.12334.083 na semana
- Crescimento
- +3.018estrelas em 5 dias
Estrelas ao longo do tempo
Fatos
- Roda em
- Windows, macOS, Linux
- Você precisa instalar
- Nada além do programa
- Para compilar a partir do código
- Node.js, Docker
- Espaço em disco
- 104 MB–311 MB · pelo instalador
- Contas ou chaves
- Free-tier keys from the providers you choose (Google, Groq, Cerebras, Mistral, OpenRouter, Cloudflare, Cohere, NVIDIA, Hugging Face and 25 more), FreeLLMAPI premium key (fla_), for the live catalogue
- Custo
- Freemium · O programa é gratuito e tem licença MIT. Um plano pago (US$ 19 por ano ou US$ 49 à vista, via Stripe) só libera o catálogo de modelos do mesmo dia; a instalação gratuita recebe uma captura mensal e o README diz que ela "currently sits about 303 models behind". Os planos gratuitos dos próprios provedores não custam nada, mas têm limites.
- Licença
- MIT (Permissiva)
- Pode substituir
- OpenRouter, Portkey, ChatGPT Plus
- Última atualização
- 31 de out. de 2026
Sinais de risco (7)
- Atençãoo autor diz que é só para experimentação pessoal
A descrição do repositório termina com "Personal experimentation only." e a seção Limitations diz: "no frontier models, variable latency, no SLA — and the effective intelligence of the endpoint dips late in the day as top models hit their daily caps", com uma indicação para "the honest list ... before building anything real on this".
revisão por IA
- Atençãodepende das regras dos planos gratuitos de outras empresas
Todo o propósito é empilhar os planos gratuitos de 34 empresas ("7.4 billion tokens per month") atrás de um único endereço. Cada um desses planos gratuitos tem seus próprios termos, cotas e regras sobre contas e uso automatizado, e um provedor pode reduzir uma cota, bloquear uma chave ou fechar uma conta a qualquer momento; o próprio README diz "the free-tier landscape shifts weekly". O catálogo pago existe por causa disso.
revisão por IA
- Atençãoo instalador de uma linha encaminha um script ao bash
Início rápido: `curl -fsSL https://freellmapi.co/install.sh | bash`, que baixa um script do site do projeto e o executa imediatamente. O README oferece o script para leitura antes, e os instaladores de desktop evitam esse passo.
revisão por IA
- Atençãoguarda todas as suas chaves de provedores em um único banco de dados
As chaves dos provedores ficam "AES-256-GCM encrypted in SQLite and decrypted in-memory per request". Fora de produção, a chave de criptografia é gerada automaticamente e gravada em um arquivo chamado .encryption-key junto desse banco de dados com permissões 0600, então o cadeado e a caixa ficam na mesma pasta. O app de desktop também entra no painel "with a hidden local account", sem senha.
revisão por IA
- Infoentra em contato com o fornecedor duas vezes por dia
O roteador "pulls a signed catalog from freellmapi.co twice a day", verificado contra uma chave Ed25519 fixa. O README diz "The catalog server never sees your prompts, completions, or provider keys", e é o plano premium que faz esse feed ser do mesmo dia.
revisão por IA
- Infoa atualização automática opcional precisa do socket do docker
O docker-compose.yml tem um perfil opcional `autoupdate` que roda o Watchtower com `/var/run/docker.sock` montado, e o próprio comentário diz que isso "is root-equivalent on the host — leave the profile off if that is not acceptable".
revisão por IA
- Infoa exposição na rede é responsabilidade do usuário
O arquivo compose vincula a porta a 127.0.0.1 e declara que o FreeLLMAPI "is single-user and must not be exposed to the internet"; HOST_BIND=0.0.0.0 o abre para a rede local, "guarded only by the unified API key".
revisão por IA
As evidências aparecem no idioma original.
O que o Radar não conseguiu verificar
- Se a capacidade anunciada (7,4 bilhões de tokens por mês, 635 endpoints) é alcançável na prática, e quanto disso suas próprias contas realmente conseguem.
- Quão consistentes ficam as respostas quando as solicitações pulam entre vários modelos gratuitos diferentes.
- Se verificar o estado das chaves custa dinheiro: a configuração observa que o ModelScope valida uma chave com uma solicitação paga de um token que consome cota em cada verificação.
- Se os instaladores de desktop são assinados, e o que o Windows ou o macOS avisam ao abri-los.
- O que os provedores dos planos gratuitos registram sobre seus prompts do lado deles.