Metadata-Version: 2.4
Name: bytinho
Version: 0.4.0
Summary: Bytinho — um pet digital pra devs que vive no terminal
Author-email: Andryus <admin@qantara.com.br>
License: MIT
Project-URL: Homepage, https://bytinho.qantara.com.br
Project-URL: Repository, https://github.com/andryus/bytinho
Project-URL: Issues, https://github.com/andryus/bytinho/issues
Keywords: tamagotchi,cli,terminal,pet,dev,ascii
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
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 :: Games/Entertainment
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Requires-Dist: httpx>=0.27
Requires-Dist: platformdirs>=4.2
Requires-Dist: websockets>=12.0
Dynamic: license-file

<div align="center">

# Bytinho 🐣

**Um Tamagotchi para devs que vive no seu terminal.**
Cada `git commit` vira XP. Seu pet evolui, ganha conquistas, conversa com você
sobre o seu próprio histórico de código.

[![PyPI version](https://img.shields.io/pypi/v/bytinho.svg?color=ff79c6)](https://pypi.org/project/bytinho/)
[![Python](https://img.shields.io/pypi/pyversions/bytinho.svg?color=8be9fd)](https://pypi.org/project/bytinho/)
[![License: MIT](https://img.shields.io/badge/license-MIT-50fa7b.svg)](LICENSE)
[![Status](https://img.shields.io/website?url=https%3A%2F%2Fbytinho.qantara.com.br%2Fhealth&label=The%20Core&color=bd93f9)](https://bytinho.qantara.com.br/health)

[![Bytinho](https://bytinho.qantara.com.br/u/andryus.svg)](https://bytinho.qantara.com.br/u/andryus)

</div>

---

## ✨ Por que existe

Você commita todo dia. Por que isso não pode ter um **bichinho fofo** te
acompanhando, evoluindo junto, te chamando atenção quando você some?

Bytinho é isso: um **pet digital ASCII** que vive no terminal, sobe de nível
com seus commits e tem **personalidade própria** que reage ao seu estilo de
codar (linguagens favoritas, vícios noturnos, semanas só de `fix:`...).

```
        ___
       /   \
      /     \
     |   o   |        Bytinho de @você  😺  Junior Dev  •  Lv.4  •  240 XP
      \     /         🟢 The Core online   💬 12 online   🔥 7d streak
       \___/
   ~-~-~-~-~-~-

   🍕 Fome      ━━━━━━━━━━━━━━━━━━━━━━━━━━━╸━━━━
   🔋 Energia   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   😊 Humor     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╸━
   🧠 Mente     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   💬 Eita preula! Sua fav é Rust com TOML e Markdown kkk 🦀✨
```

## 🚀 Instalar

```bash
pipx install bytinho      # ou: pip install --user bytinho
bytinho nick seu-nick     # define seu apelido global
bytinho install-hook      # cada git commit vira XP automático
bytinho                   # ver seu pet vivo
```

> ✅ Funciona em **Linux**, **macOS** e **WSL**. Python ≥ 3.10.
> 🔒 Servidor por trás de Cloudflare. UUID local — sem login, sem senha.

## 🎮 Comandos principais

| Comando | O que faz |
|---|---|
| `bytinho` | Mostra seu pet vivo (animado) |
| `bytinho code N` | Registra N commits manualmente |
| `bytinho install-hook` | Hook automático: `git commit` → XP |
| `bytinho sync-history --days 30` | Importa últimos 30 dias de commits do repo atual |
| `bytinho talk "oi"` | Conversa com o Bytinho (ele lembra do seu histórico) |
| `bytinho feed` / `play` / `sleep` / `wake` | Cuida do bichinho |
| `bytinho streak` | Vê seu streak diário |
| `bytinho ranking` | Top 10 da semana |
| `bytinho achievements` | Suas conquistas |
| `bytinho share` | Copia badge markdown pra README |
| `bytinho chat` | Chat global em tempo real |
| `bytinho export` / `import` | Backup do seu pet |

Lista completa: `bytinho --help`

## 🧠 O que torna especial

### Hook git que entende o seu commit
Cada commit é analisado **localmente** — o Bytinho extrai linguagens, tipo
(`feat:`, `fix:`, `refactor:`...), linhas adicionadas/removidas, e usa isso pra
desbloquear conquistas e personalizar respostas. **Nada de código sai do seu
PC**, só agregados.

### Personalidade reativa via Grok
O Bytinho conhece o seu padrão dos últimos 7 dias. Pergunta "to cansado" e
ele responde *"Eita, descansa pra gente fixar mais Rust!"* — porque sabe que
você anda commitando muito Rust à noite.

### 19 conquistas (e contando)
- 🌱 Primeiro Commit · 🦉 Coruja (commit >22h) · 🌅 Madrugador
- 🐍 Poliglota de Verdade (3+ linguagens) · 📚 Doc Lover (commit só de markdown)
- 🐛 Bug Hunter (10× `fix:`) · 🧹 Refactor King · 🏭 Feature Factory
- 💥 Big Bang (500+ linhas) · 🎯 Surgeon (10× <10 linhas)
- 🌉 Friday Shipper · 🔥 streak 7d/30d/100d · 🏆 Top 10 semanal
- ... e mais

### Perfil público com badge
```markdown
[![Bytinho](https://bytinho.qantara.com.br/u/seu-nick.svg)](https://bytinho.qantara.com.br/u/seu-nick)
```

## 🔐 Privacidade

- ❌ Não enviamos seu código
- ❌ Não enviamos nomes de arquivos
- ❌ Não armazenamos URLs de remotes
- ✅ Só agregados: linguagens, tipo do commit, contagens de linhas
- ✅ UUID local — sem cadastro, sem senha
- ✅ Mensagens de chat efêmeras (TTL 7 dias)

## 🏗️ Arquitetura

```
┌─────────────────────────────┐         ┌──────────────────────────┐
│  bytinho (CLI)              │ HTTPS   │  The Core (FastAPI)      │
│  Python · Rich · Typer      │────────▶│  bytinho.qantara.com.br  │
│  hook git post-commit       │         │  SQLite WAL · Cloudflare │
└─────────────────────────────┘         └──────────────────────────┘
```

Repo em **monorepo**:

| Pasta | O que é | Visibilidade |
|---|---|---|
| `cli/` | Pacote `bytinho` (publicado no PyPI) | 🟢 Open source · contribuições bem-vindas |
| `server/` | The Core (servidor central) | 🔒 Fechado · hospedado pelo criador |

O Bytinho é jogável **localmente** (estado em cache); funcionalidades sociais
exigem o servidor central.

## 🤝 Contribuir

Pull requests no `cli/` são muito bem-vindos. Veja [CONTRIBUTING.md](CONTRIBUTING.md).

Ideias com `good first issue`:
- novos sprites pra estágios `tenx` e `legend`
- traduções (EN, ES, JP)
- conquistas criativas
- comandos `/me`, `/roll`, `/flex` no chat

## 💜 Apoie

Bytinho é grátis. The Core é mantido com café por doações.
- ⚡ USDT TRC20: `(em breve)`
- 🐙 GitHub Sponsors: `(em breve)`
- ☕ Ko-fi: `(em breve)`

Padrinhos ganham ⭐ vitalícia no perfil público + sprites exclusivos.

## 📜 Licença

[MIT](LICENSE) © Andryus · Qantara

