Um ser vivo digital que mora no seu computador e cresce com você. 🌙

Companhia • bem-estar • autocuidado • memória viva — 100% offline, 100% seu.

Stack

---

✨ O que é o LUMA

O LUMA é um companheiro digital que vive na sua área de trabalho. Você adota uma criatura, ela nasce de um ovo, cresce conforme você cuida de si mesmo, e constrói com você um mundo vivo que reflete a sua jornada — sem números, sem cobrança, sem julgamento.

É a mistura de Tamagotchi + Finch + Replika + Animal Crossing, mas com uma combinação que ninguém mais junta:

🪄 Ser vivo no desktop + IA 100% local + memória persistente + mundo espelho + ética no núcleo. Tudo offline, privado e seu.

🥚 Nasce e cresce ovo → bebê → adulto, conforme o cuidado	🧠 Lembra de você memória viva + IA local (Ollama)	🌌 Mundo espelho sua jornada vira paisagem
🌿 Autocuidado gentil hábitos, respiração, diário	💛 Ponte para ajuda real rede de apoio + CVV/CAPS/SAMU	🔒 Privacidade radical tudo local, exportável, apagável

O que o LUMA não é

Terapia, diagnóstico ou tratamento médico — e nunca substitui um profissional de saúde, um psicólogo ou um amigo. Ele é companhia e bem-estar, e sempre incentiva a conexão humana real. A camada de segurança (Safety Layer) é obrigatória em toda interação com a IA.

---

🖼️ Visual

Personagens em estilo kawaii vetorial (corpo inteiro, traços por espécie, cor única por personagem). Abra as galerias no navegador:

Galeria	Arquivo
🐾 100 personagens	docs/art/catalog-gallery.html
🎬 Pet animado (5 estados)	docs/art/pet-animated-demo.html
🎨 Estilos de arte	docs/art/style-preview.html

_{A direção de arte é híbrida: vetorial por padrão (escala para 100+), com caminho para sprites/ilustração ricos via Plugin Engine — ver docs/15-ARTE-PIPELINE-HIBRIDO.md.}

---

🧩 Funcionalidades

🏡 Casa — pet vivo, reage ao humor	💬 Conversa — IA local com memória	🌌 Mundo espelho — paisagem da jornada
📖 História — narrativa contínua	📓 Diário — vira estrelas no mundo	🌿 Hábitos — check-in gentil + streak
🫧 Respirar — minigame de calma	🎣 Pescar — minigame cozy	🎀 Loja — skins (fagulhas)
💛 Apoio — contatos + recursos de crise	🏆 Conquistas — badges sem punição	⚙️ Ajustes — IA, país, privacidade

Por baixo: Emotional Context Engine (lê o tom, sem clínica), Memory tiers (curto/longo/emocional/marco), Growth Engine (ciclo de vida), AI Orchestrator (escolhe o melhor modelo local pela sua RAM), Plugin Engine (extensível) e mais.

---

🚀 Começando

Pré-requisitos

• Node.js 18+ e pnpm 9+
• Rust (para o app desktop via Tauri)
• (opcional) Ollama para IA local de verdade

Rodar o app desktop

pnpm install
pnpm --filter @luma/desktop tauri dev

IA local (opcional)

ollama pull phi3:mini      # ou gemma2:2b, llama3.2, qwen2.5, mistral...
# depois, no app: ⚙️ Ajustes → IA local (Ollama) → Testar conexão

Comandos úteis

pnpm -r test            # roda todos os testes (Vitest)
pnpm -r typecheck       # checagem de tipos
pnpm --filter @luma/characters generate   # (re)gera os 100 personagens
pnpm --filter @luma/characters gallery    # gera a galeria visual

---

🏛️ Arquitetura

Monorepo offline-first com engines de domínio puras (testáveis, reutilizáveis entre Desktop / Web / Mobile).

tamago/
├── packages/
│   ├── shared/      # tipos + contratos (sem I/O, sem framework)
│   ├── core/        # 20+ engines puras: tamagotchi, memory, emotion, growth,
│   │                #   ai, safety, world, narrative, plugin, fishing...
│   ├── characters/  # 100 personagens (gerador) + renderizador SVG
│   └── db/          # schema SQLite + PostgreSQL
└── apps/
    └── desktop/     # Tauri + React + Zustand + Tailwind (app nativo)

📚 Documentação completa em docs/: Arquitetura · Roadmap · Banco de dados · Memory Engine · Safety Layer · Estado atual · Plano de implementação

Princípios inegociáveis

1. Offline-first — funciona 100% sem internet.
2. Sem barras — o estado é sentido (luz, clima, animação), não lido em números.
3. Sem culpa, sem manipulação — o pet nunca usa "você me abandonou".
4. Privacidade radical — dados locais, exportáveis e apagáveis.
5. Ética no núcleo — a Safety Layer envolve toda I/O da IA.

---

🤝 Contribuindo

Toda ajuda é bem-vinda — de código a arte, de ideias a tradução. Leia o guia completo em CONTRIBUTING.md.

Formas de contribuir:

• 🎨 Criar personagens ou sprites (o Plugin Engine aceita packs!)
• 🐛 Reportar bugs ou sugerir features via Issues
• 💻 Código — pegue uma issue marcada good first issue
• 🌍 Tradução e acessibilidade
• 📖 Documentação

💗 Este é um projeto de bem-estar. Pedimos que toda contribuição respeite a filosofia do LUMA: gentileza, privacidade e nada que substitua ajuda profissional.

---

🗺️ Roadmap

• Fase 1 — Desktop Pet + Character + Mood
• Fase 2 — Chat + IA Local + Memory
• Fase 3 — Relationship + World + Hábitos + Crescimento
• Sprints A–D — Emoção, Memória em camadas, Narrativa, Eventos, AI Orchestrator, Plugin Engine
• Fase 4 — Web sincronizada + Backend + Sync
• V2 — Família do pet (moradores), Mobile, galeria comunitária

Detalhes em docs/02-ROADMAP.md e docs/14-ROADMAP-UNIFICADO.md.

---

📜 Licença & Crédito

Código sob licença MIT (ver LICENSE). Conteúdo de terceiros, quando reutilizado, é creditado em NOTICE.

_{Feito com 💗 para fazer companhia.
LUMA não substitui ajuda profissional. Em crise no Brasil, ligue para o CVV: 188 (24h, gratuito).}