A privacy-first, local-only AI conversation platform designed to uncover behavioral insights and identify mindful individuals through authentic, personality-driven interactions. Experience meaningful connection discovery with our advanced compatibility evaluation system, featuring modern UI/UX design, robust error handling, and complete data privacy - all data stays on your machine!
- 🧠 AI Personality Engine: Context-aware conversations with advanced personality modeling
- 📊 Compatibility Core: Automatic behavioral pattern recognition and scoring
- 🛡️ Insight Shield: Comprehensive error handling with graceful fallbacks
- 📝 Conversation Logs: Detailed interaction tracking and behavioral analysis
- ⚙️ Profile Configuration: Easy-to-modify personality and evaluation parameters
- 🎯 Type Safety: Full TypeScript implementation for enterprise-grade code quality
- 🚀 Fallback Systems: Automatic AI service switching for maximum reliability
- 🔧 Input Validation: Advanced input validation and conversation sanitization
- 🌌 Communication Array: Beautiful web-based chat interface with glass morphism
- 🎨 Mindful Theme: Elegant design with gradient backgrounds and smooth animations
- 📱 Responsive Design: Works perfectly on desktop, tablet, and mobile
- ✨ Modern UI/UX: Smooth transitions, hover effects, and intuitive navigation
- 🔄 Real-time Updates: Live compatibility scoring and behavioral insights
- 🌍 Offline Mode: Complete functionality with local storage fallback
- 🏠 Privacy-First Design: All AI processing happens locally - no data leaves your machine
- 🦙 Ollama Integration: Local LLM support with Llama 3.1, Mistral, and other models
- 📚 Life Wisdom Engine: Comprehensive knowledge base for meaningful conversations
- 🔄 Intelligent Fallback: Graceful degradation to wisdom-based responses when Ollama unavailable
- ⚡ Performance Optimized: Fast local processing with minimal resource usage
- 🛡️ Complete Privacy: No cloud AI services, no data transmission, no external dependencies
🛡️ Privacy-First: All AI processing happens locally with Ollama - no data ever leaves your machine!
# Clone or download the project
cd meaningful-ai
# Launch the Insight Engine
npm install
npm run dev
# Optional: Setup Offline AI (Recommended for better conversations)
npm run setup:ollamaAccess URL: http://localhost:3000
Offline AI Setup: The app works great with just the built-in wisdom system, but for enhanced conversations, run npm run setup:ollama to install Ollama with Llama 3.1 8B for offline AI conversations.
The Behavioral Insight Engine will automatically:
- Initialize the AI personality system
- Set up conversation tracking
- Launch the modern web interface
- Begin behavioral pattern analysis
# 1. Install dependencies
npm install
# 2. Set up environment
cp env.template .env.local
# 3. Configure your AI personality
# Edit src/config/profile.json with your values and preferences
# 4. Add API keys to .env.local
OPENAI_API_KEY=your_openai_api_key_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here # Optional fallback
# 5. Launch the engine
npm run dev- 🚀 Launch: Open http://localhost:3000 in your browser
- 📡 Communication: Start conversations to analyze behavioral patterns
- 🧠 AI Analysis: Watch as the system evaluates compatibility and mindfulness
- 📊 Insights: Review behavioral insights and compatibility scores
- 🔬 Admin Dashboard: Access detailed analytics at
/admin(password: admin123)
🧠 Meaningful AI - Behavioral Insight Engine
🌌 Welcome to authentic conversation analysis 🌌
📡 User: Hi! I'm really interested in personal growth and mindfulness.
🚀 AI Analysis: [Analyzing response patterns...]
🌌 Behavioral Insights:
👤 User: Hi! I'm really interested in personal growth and mindfulness.
🤖 AI Core: That's wonderful! I appreciate your openness about growth. What draws you to mindfulness? Is it something you've practiced for a while, or are you exploring new ways to connect with yourself?
📊 Compatibility Score: 78/100
🟢 Green Flags: Growth mindset, Self-awareness, Authenticity
🔴 Red Flags: None detected
The Behavioral Insight Engine can be customized by modifying the ProfileConfig in src/config/profile.json:
{
"name": "Your AI Personality",
"values": [
"authenticity",
"growth mindset",
"emotional intelligence",
"mindfulness"
],
"filters": {
"greenFlags": [
"genuine curiosity",
"self-awareness",
"emotional maturity",
"mindfulness practice"
],
"redFlags": [
"superficial interactions",
"lack of empathy",
"closed mindset"
]
}
}The web interface theme can be customized by modifying the CSS in src/app/globals.css:
- Colors: Change the gradient backgrounds and accent colors
- Fonts: Modify the Geist font family
- Animations: Adjust transition effects and hover states
- Layout: Customize the glass morphism panels
Current AI Personality Engine: Custom GPT-4o-mini with Claude-3 Haiku fallback
- 🧠 Type: Advanced Conversational AI with Personality Modeling
- 📊 Parameters: Context-aware behavioral pattern recognition
- 💾 Memory Usage: Optimized conversation history management
- ⚡ Response Time: ~1-3 seconds with fallback systems
- 🌌 Capabilities: Compatibility scoring, behavioral insights, personality matching
The system analyzes behavioral patterns across multiple dimensions:
| Behavioral Factor | Weight | Description |
|---|---|---|
| Value Alignment | 25% | Core values and principles compatibility |
| Emotional Intelligence | 20% | Empathy, self-awareness, emotional maturity |
| Authenticity | 20% | Genuine self-expression vs. performative behavior |
| Communication Style | 15% | How they express thoughts and feelings |
| Growth Orientation | 10% | Openness to learning and personal development |
| Depth of Responses | 5% | Thoughtfulness and engagement level |
| Respectfulness | 3% | Basic human decency and consideration |
| Intellectual Curiosity | 2% | Question-asking and exploration behavior |
meaningful-ai/
├── 🚀 src/
│ ├── 🌌 app/ # Next.js app router
│ │ ├── admin/ # Behavioral analytics dashboard
│ │ ├── api/chat/ # Conversation analysis endpoints
│ │ └── page.tsx # Main conversation interface
│ ├── 🧠 components/ # React conversation components
│ ├── 📊 lib/ # Core behavioral analysis services
│ │ ├── ai-service.ts # AI personality engine
│ │ ├── database.ts # Behavioral data persistence
│ │ ├── evaluation-engine.ts # Compatibility scoring system
│ │ └── config.ts # Configuration loader
│ ├── 🎯 types/ # TypeScript behavioral definitions
│ └── ⚙️ config/ # AI personality configuration
├── 🛠️ setup.sh # Quick setup script
├── 📋 env.template # Environment variables template
├── 📖 README.md # Mission documentation
└── 🚫 .gitignore # Git ignore rules
- 🌌 Chat Interface (
ChatInterface.tsx): Modern conversation experience - 📊 Admin Dashboard (
admin/page.tsx): Behavioral analytics and insights - 🧠 AI Service (
ai-service.ts): Personality-driven conversation engine - 📈 Evaluation Engine (
evaluation-engine.ts): Compatibility scoring system
The Behavioral Insight Engine creates detailed conversation logs:
- 🚀 AI personality initialization progress
- ❌ Error messages and diagnostic traces
- 🔄 Conversation history and pattern analysis
- 📊 Behavioral insights and compatibility metrics
- 🛸 Interaction session summaries
- 🚀 AI Service Loading: Graceful failure with helpful diagnostic messages
- 🔧 Input Validation: Advanced conversation sanitization and validation
- ⚡ Generation Errors: Intelligent fallback responses when AI fails
- 💾 Memory Management: Automatic cleanup to prevent system crashes
- 🌐 Network Issues: Offline mode resilience and error recovery
- 🚀 Dual AI Services: OpenAI primary with Anthropic fallback
- 💾 Memory Management: Configurable conversation history limits
- 🔧 Efficient Processing: Optimized text analysis algorithms
- ⚡ Batch Processing: High-performance behavioral analysis
- 🌌 Resource Monitoring: Real-time performance tracking
| Issue | 🛠️ Solution |
|---|---|
| 💾 Memory Overload | Reduce conversation history limits or use local storage |
| 🐌 Slow Performance | Check API key configuration and network connection |
| 🌐 API Failures | Verify OpenAI/Anthropic API keys and fallback systems |
| ❌ Import Errors | Ensure all dependencies are properly installed |
| 🔒 Admin Access | Use default password admin123 or check environment config |
- 🚀 First Launch: Slower due to AI model initialization (~2-5 seconds)
- 🔄 Subsequent Runs: Much faster as models are cached
- 🚀 API Users: Ensure valid API keys for optimal performance
- 💾 Memory Issues: Use local storage fallback for offline functionality
- 🌌 Resource Monitoring: Check browser console for detailed diagnostics
The Behavioral Insight Engine includes comprehensive testing protocols:
# Test behavioral analysis system
npm run build # Test production build
npm run lint # Test code quality
npm run dev # Test development server
# Test fallback systems
npm run test:fallback # Test AI service fallback mechanisms- 🤖 @anthropic-ai/sdk (≥0.60.0): Anthropic AI fallback service
- ⚡ openai (≥5.15.0): OpenAI primary AI service
- 🌐 next (≥15.5.0): Next.js web framework
- 🎨 tailwindcss (≥4.0.0): Modern styling framework
- 📊 @supabase/supabase-js (≥2.56.0): Optional cloud storage
- 🎭 framer-motion (≥12.23.12): Smooth animations and transitions
This Behavioral Insight Engine uses AI services and libraries with their respective licenses:
- 🤖 OpenAI API: OpenAI Terms of Service
- 🧠 Anthropic API: Anthropic Terms of Service
- 🚀 Behavioral Analysis Implementation: MIT License
If you encounter any mission issues:
- 🔍 Check the Behavioral Analysis Diagnostics section above
- 📝 Review the browser console for detailed error logs
- 🔧 Ensure all dependencies and API keys are properly configured
- 🚀 Try using the local storage fallback for testing
- 🌐 Check the GitHub issues for known behavioral analysis problems
🧠 Welcome to the Future of Meaningful Connection Discovery! 🎯