Flopiti Atlas

Proyecto archivado - Prototipo de aprendizaje para explorar UI/UX de companions digitales.

Un companion de escritorio con personalidad, animaciones y pensamientos generados por AI.

Qué es

Flopiti Atlas es un widget de escritorio con un personaje animado que:

• Tiene personalidad calibrable (5 traits)
• Genera pensamientos usando Claude Haiku
• Reacciona a interacciones (shake, pet, poke)
• Sistema de mood basado en necesidades internas
• Recordatorios tipo Pomodoro

Instalación

Mac (Apple Silicon)

1. Descargar Flopiti Atlas-0.1.0-arm64.dmg de Releases
2. Abrir el .dmg y arrastrar a Aplicaciones
3. Primera vez: Click derecho → Abrir (por no estar firmado)

Desde código fuente

git clone https://github.com/[user]/flopiti-atlas
cd flopiti-atlas
npm install
npm run electron:dev

Arquitectura

Ver ARCHITECTURE.md para detalles técnicos.

Stack:

• Frontend: React 19 + TypeScript + TailwindCSS
• Desktop: Electron 40
• Backend: Convex (serverless)
• AI: Claude Haiku (Anthropic)

Lecciones Aprendidas

Este proyecto fue un prototipo para explorar:

1. UI/UX de companions - Sprites, animaciones, sistema de moods
2. Personalidad con LLMs - Traits calibrables, memoria, thoughts
3. Arquitectura rule-based - DecisionEngine, NeedsSystem

Conclusión: La arquitectura rule-based (if-else) no escala para un companion verdaderamente "inteligente". El siguiente paso sería un agente LLM-driven donde el modelo toma decisiones, no solo genera texto.

Ver docs/plans/new-project-ai-agent.md para el plan del siguiente proyecto.

Desarrollo

# Web development
npm run dev

# Electron development
npm run electron:dev

# Electron con DevTools
npm run electron:debug

# Build para distribución
npm run electron:build

Licencia

MIT