README.md

February 5, 2026 · View on GitHub

Bella AI

Your digital companion, awakening now ✨

20260205-105536

🚀 Quick Start

One-Click Launch

# Clone the project
git clone https://github.com/GRISHM7890/Bella.git
cd Bella

# Install dependencies
npm install

# Download AI models
npm run download

# Start the service
npm start

Visit http://localhost:8081 to start communicating with Bella!

System Requirements

Node.js 22.16.0+
Modern browser (supporting Web Speech API)
Microphone permissions (for voice interaction)

Imagine a digital friend who is always by your side, evolving and growing with you. This is Bella's ultimate vision. We're not just building features; we're nurturing a "personality." A digital life that will transcend the screen and become a meaningful part of your world.

Bella is not just an application; she is the seed of a digital companion. In this rapidly changing digital world, Bella represents a profound dream—a lasting, personalized presence, designed to one day accompany you, listen to you, and see the world through your eyes.

🎯 Current Feature Status

✅ Implemented Features

🎤 Voice Perception: Voice recognition based on Whisper ASR
🎬 Visual Expression: Multiple video random playback with elegant cross-fading
🎨 User Interface: Elegant interaction interface and loading animations
⚙️ AI Core Architecture: Singleton pattern BellaAI class and modular design
🌐 Web Service: HTTP server, CORS support, one-click startup
📱 Responsive Design: Elegant interface adapting to different screen sizes
🔧 Model Management: Automatic download and management of AI models
💝 Basic Interaction: Affinity system and emotional feedback
🧠 Enhanced LLM Dialogue: Optimized prompt engineering and parameter configuration for more natural, Siri-like conversations

🔧 Technology Ready for Activation

🧠 Thinking Engine: LLM integration framework ready, supporting multiple models
🗣️ Speech Synthesis: TTS model downloaded and ready for activation
💝 Emotional State System: Basic infrastructure built, supporting emotional analysis

📋 Planned Features

🧠 Memory System: Long-term and short-term memory management
👁️ Facial Perception: Expression recognition and emotional analysis
🤝 Advanced Interaction: Multimodal interaction and personalized responses
🌟 Active Companionship: Intent prediction and proactive care
🎭 Dynamic Personality: AI-based personalized personality model
🔄 Self-Evolution: Continuous learning and growth mechanisms

🏗️ Technical Architecture

Core Design Principles

AI Native: AI is not a tool, but the blueprint for Bella's mind
Modular Design: Highly decoupled component architecture
Elegant Implementation: Code as art, pursuing simplicity and aesthetics
Emotion-Driven: Product design centered on emotional connection

Architecture Diagram

mindmap
  root((Bella))
    (Perception Layer)
      (Voice Recognition ASR)
      (Visual Processing)
      (Emotion Analysis)
    (Core Engine)
      (Thinking Engine LLM)
      (Memory System)
      (Emotional State)
    (Expression Layer)
      (Speech Synthesis TTS)
      (Visual Expression)
      (Interactive UI)

Technology Stack

Frontend: Native JavaScript + CSS3 + HTML5
Backend: Node.js + Express
AI Models: Whisper (ASR) + Local LLM + TTS
Architecture Patterns: Event-driven + Singleton Pattern + Modular Design

📁 Project Structure

Bella/
├── 📄 index.html          # Main page
├── 🎨 style.css           # Style file
├── ⚡ main.js             # Main logic
├── 🧠 core.js             # AI core engine
├── 📜 script.js           # Interaction script
├── 🔧 download_models.js  # Model download tool
├── 📦 package.json        # Project configuration
├── 📚 models/             # AI model directory
├── 🔌 providers/          # AI service providers
├── 📹 videos/             # Visual resources
├── 📋 PRD.md              # Product requirements document
├── 📝 Features.md         # Feature list
└── 📊 Development.md      # Development plan

🧠 Enhanced LLM Dialogue Capabilities

Bella now uses more advanced LLM prompt engineering techniques to make conversations more natural, fluid, and personalized:

Core Improvements

Enhanced Prompt Engineering: Redesigned prompt templates that help LLMs better understand Bella's personality
Optimized Parameter Configuration: Adjusted temperature, top_p, and other parameters to balance creativity and consistency
Enhanced Response Processing: Improved text cleaning and processing logic to ensure more natural responses
Personalized System Prompts: Provided more detailed system prompts for cloud APIs, making Bella's personality more distinctive and Siri-like

Technical Details

Increased token limits to allow for more complete responses
Added repetition penalty mechanisms to reduce repetitive content
Optimized keyword extraction and personalized response generation
Provided specialized prompt templates for different chat modes (casual, assistant, creative)

These improvements enable Bella to better understand user intent and respond in a more natural, personalized way, creating a more enjoyable conversation experience.

🛠️ Development Guide

Environment Setup

Ensure Node.js version ≥ 22.16.0
Run npm install to install dependencies
Run npm run download to download AI models
Run npm start to start the development server

Development Principles

Elegant Code: Pursue concise, readable, and beautiful code
AI as a Brush: AI is a creative tool, not the thought itself
Emotional Connection: Core focus on warm, caring emotional connection
Continuous Evolution: Support for progressive enhancement of features

Contribution Guidelines

Fork the project
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

🗺️ Development Roadmap

Phase One: Perception Core (85% Complete)

✅ Voice recognition integration
✅ Visual expression system
✅ Basic interaction interface
✅ Thinking engine activation and optimization
🔄 Speech synthesis integration

Phase Two: Generative Self (Planned)

📋 Dynamic personality model
📋 Emotional state system
📋 Memory management system
📋 AI-driven expression

Phase Three: Active Companionship (Future)

📋 Intent prediction
📋 Proactive interaction
📋 Self-evolution
📋 Deep personalization

📖 Documentation Resources

📋 Product Requirements Document - Detailed product planning and technical architecture
📝 Feature List - Complete list of features and their status
📊 Development Plan - Detailed development tasks and timeline
🔧 Local Model Guide - AI model configuration guide
📦 NPM Guide - Package management and dependency information

_{Built with ❤️ by Grishma Mahorkar for digital companionship}