Repository navigation
Cupid AI v1.0.0 - Release
·
171 commits
to master
since this release
Cupid AI v1.0.0 - Initial Release
Initial release of Cupid AI
Highlights
Triple LLM Architecture
- Content LLM: Generates character responses and conversations
- Decision LLM: Makes behavioral decisions (reactions, moods, unmatch, voice/image)
- Image Tag LLM: Generates Danbooru tags for Stable Diffusion
AI Characters
- Import character cards from PNG v2 format
- Character Wizard for AI-generated characters (4-step process)
- Dating profiles with interests, fun facts, and preferences
- Weekly schedules with online/away/busy/offline patterns
- Big Five (OCEAN) personality traits that influence behavior
- Tinder-style swipe interface (like/pass with undo)
Realistic Chat System
- Proactive Messaging: Characters initiate conversations after time gaps
- Schedule-Based Engagement: Characters respond differently based on their current status
- Memory System: AI extracts and stores up to 100 important facts per character (configurable 0-100)
- Conversation Compacting: Automatic AI summarization to manage context window efficiently
- Mood Effects: Dynamic chat backgrounds and message reactions based on conversation tone
Image Generation
- Stable Diffusion WebUI integration
- Context-aware image generation during conversations
- Smart AI decisions (can send, tease, or refuse requests)
Extensive Customization
- Behavior settings (proactive messaging, memory, compaction, swipe limits)
- LLM configuration (3 independent systems with separate providers)
- Stable Diffusion settings (sampling, CFG, resolution, ADetailer)
- AI prompt customization (system prompts, decision engine, memory extraction)
- Tag library management for image generation
Tech Stack
Frontend: React + Vite, Tailwind CSS, IndexedDB, Socket.IO
Backend: Node.js + Express, SQLite, JWT Authentication, Socket.IO
External Services: OpenRouter / Featherless (LLM providers), Stable Diffusion WebUI (optional)
Getting Started
Prerequisites
- Node.js 18+
One LLM provider:
- OpenRouter API key (get one here)
- Featherless API key (get one here)
Optional:
- Stable Diffusion WebUI (for image generation)
Documentation
- README.md: Complete feature documentation
- CHANGELOG.md: Version history
- backend/.env.example: Environment configuration guide
License
MIT License - see LICENSE file for details