Metadata-Version: 2.4
Name: vfree
Version: 0.1.0
Summary: vibe coding sem rate limit · qualquer LLM · seu terminal
Project-URL: Homepage, https://github.com/schliesing/vibe-free
Project-URL: Documentation, https://github.com/schliesing/vibe-free#readme
Project-URL: Repository, https://github.com/schliesing/vibe-free
Project-URL: Issues, https://github.com/schliesing/vibe-free/issues
Project-URL: Support, https://ko-fi.com/webdevrafa
Author-email: Rafael Schliesing <rafael@licitatech.online>
License-Expression: MIT
License-File: LICENSE
Keywords: claude-code,cli,coding,llm,ollama,vibe
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: keyring>=25.0.0
Requires-Dist: keyrings-alt>=1.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: questionary>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tomli>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# Vibe-Free

```
██╗   ██╗██╗██████╗ ███████╗   ███████╗██████╗ ███████╗███████╗
██║   ██║██║██╔══██╗██╔════╝   ██╔════╝██╔══██╗██╔════╝██╔════╝
██║   ██║██║██████╔╝█████╗     █████╗  ██████╔╝█████╗  █████╗
╚██╗ ██╔╝██║██╔══██╗██╔══╝     ██╔══╝  ██╔══██╗██╔══╝  ██╔══╝
 ╚████╔╝ ██║██████╔╝███████╗   ██║     ██║  ██║███████╗███████╗
  ╚═══╝  ╚═╝╚═════╝ ╚══════╝   ╚═╝     ╚═╝  ╚═╝╚══════╝╚══════╝

       vibe coding sem rate limit · qualquer LLM · seu terminal
```

> vibe coding sem rate limit · qualquer LLM · seu terminal

[![PyPI version](https://badge.fury.io/py/vibe-free.svg)](https://pypi.org/project/vibe-free/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Stars](https://img.shields.io/github/stars/schliesing/vibe-free?style=social)](https://github.com/schliesing/vibe-free)

## O problema

Você ama Claude Code. Ama Codex. Ama o flow do CLI. Mas:

- Bate rate limit no meio da sessão
- Perde context window no momento errado
- Paga R$100+/mês e ainda assim trava

## A solução

`vibe-free` é um wizard + launcher que conecta esses CLIs aos seus
próprios modelos: locais via Ollama, ou APIs alternativas mais baratas.

Continue codando como sempre. `claude`, `codex`, `opencode` —
funcionando. Sem assinatura, sem rate limit, sem susto.

## Install

```bash
pipx install vibe-free
vibe-free init
```

(sem pipx? `pip install --user vibe-free`)

## Como funciona

1. Wizard detecta seu sistema (RAM, GPU, OS)
2. Instala Ollama se faltar
3. Recomenda modelos que cabem na sua RAM
4. (opcional) Configura suas APIs pagas como fallback
5. Você roda `vibe-free`, escolhe app + modelo, e pronto

Internamente: `ollama launch <app> --model <slug>`. Crédito pra
equipe Ollama por ter feito o trabalho pesado.

## Demo

![demo](examples/demo.gif)

[View asciicast →](https://asciinema.org/a/3F4sTFg6oWeR3e5f)

## Apps suportados

- Claude Code (`claude`) — stable
- OpenClaw (`openclaw`) — stable
- Codex (`codex`) — experimental
- OpenCode (`opencode`) — experimental
- Hermes Agent (`hermes`) — experimental

Ver [docs/apps-supported.md](docs/apps-supported.md).

## Modelos recomendados

Ver [docs/models-guide.md](docs/models-guide.md).

## Comandos

```bash
vibe-free              # Menu interativo
vibe-free init         # Wizard de bootstrap
vibe-free model pull   # Baixar modelo
vibe-free model rm     # Remover modelo
vibe-free model list   # Listar modelos locais
vibe-free api add      # Adicionar API key
vibe-free api list     # Listar APIs
vibe-free api rm       # Remover API
vibe-free apps         # Listar apps detectados
vibe-free doctor       # Diagnóstico
vibe-free support      # Abrir Ko-fi
```

## ❤ Apoie o projeto

vibe-free é grátis e sempre será. É mantido por uma pessoa
(Rafael Schliesing) nas horas de folga, no Brasil.

Se vibe-free te economizou pelo menos 1 mês de Claude Pro (US$ 20):

- ☕ Café (R$ 10): [ko-fi.com/webdevrafa](https://ko-fi.com/webdevrafa)
- 🍺 Cerveja (R$ 25): [ko-fi.com/webdevrafa](https://ko-fi.com/webdevrafa)
- 🌟 Star no GitHub
- 💼 Patrocinar feature: [ko-fi.com/webdevrafa/commissions](https://ko-fi.com/webdevrafa/commissions)

GitHub Sponsors mensal: [github.com/sponsors/schliesing](https://github.com/sponsors/schliesing)

## Disclaimer

vibe-free não é afiliado a Anthropic, OpenAI, Ollama ou qualquer
provedor de modelo mencionado. É um launcher independente que usa
APIs e CLIs públicas dessas ferramentas.

## Contributing

PRs welcome. Ver `CONTRIBUTING.md`.

## License

MIT — ver `LICENSE`.