Your complete guide to privacy-first AI companionship
By Lackadaisical Security 2025-2026
https://lackadaisical-security.com
Version: 2.0.0-rc1
🎯 Getting Started • 💬 Chat Features • 🔄 Hot-Swap Models • 🌐 Web Fetching • 💝 Emotional Intelligence • 📝 Journal • 🔌 Plugins • ⚙️ Settings • 🔒 Security
Lackadaisical AI Chat is a revolutionary privacy-first, local-first AI chat platform that puts you in complete control of your digital conversations. Unlike traditional AI chat applications that send your data to cloud servers, everything happens locally on your device by default.
v2-alpha introduces:
- 🔄 Hot-swappable AI models - Switch between 15+ models from 5 providers instantly
- 🌐 Web fetching - Real-time web search and information retrieval
- 💝 Emotional intelligence - A true friend that understands ALL your emotions
- 🧠 Enhanced memory - 1000 messages, 128K tokens, cross-session continuity
- 🔐 Production auth - JWT-based authentication with rate limiting
- 🔒 Privacy First: Your conversations stay on your device
- 🧠 Persistent Memory: AI remembers your preferences and conversation history
- 💝 Genuine Connection: Not a sanitized corporate assistant - a real friend
- 🔄 Model Freedom: Hot-swap between Ollama, OpenAI, Anthropic, Google, xAI
- 🎨 Beautiful Interface: Modern, responsive design that adapts to your style
- 🔌 Extensible: Plugin system for custom functionality
- 📝 Journal Integration: Built-in journaling with mood tracking
- ⚡ Fast & Lightweight: Optimized for performance and efficiency
- Download & Install: Get the latest version from our releases
- Configure AI Provider: Set up your preferred AI provider (local or cloud)
- Start Chatting: Begin your first conversation with your AI companion
- Customize: Personalize your experience with themes and settings
- Operating System: Windows 10+, macOS 10.15+, or Linux
- Memory: 4GB RAM minimum (8GB recommended)
- Storage: 500MB free space
- Network: Internet connection for cloud AI providers (optional)
# Clone the repository
git clone https://github.com/lackadaisical-security/lackadaisical-ai-chat.git
cd lackadaisical-ai-chat
# Install dependencies
cd frontend
npm install
# Start the application
npm run devThe chat interface is the heart of your AI experience, designed for natural, flowing conversations.
- 📝 Rich Text Input: Support for markdown, code blocks, and formatting
- 📎 File Attachments: Upload images, documents, and other files
- 🎤 Voice Input: Speak your messages with voice recognition
- ⚡ Smart Suggestions: Context-aware message suggestions
- 🔢 Character Limits: Configurable message length limits
interface Message {
id: string;
content: string;
role: 'user' | 'assistant';
timestamp: string;
model?: string;
tokens?: number;
responseTime?: number;
sentiment?: 'positive' | 'neutral' | 'negative';
}- 🧠 Memory Window: AI remembers conversation context
- 📚 Session History: Access to previous conversations
- 🎯 Focus Mode: Highlight important parts of conversations
- 🔄 Context Refresh: Clear and rebuild context as needed
Experience real-time AI responses with our streaming technology:
- ⚡ Instant Feedback: See responses as they're generated
- 🛑 Stop Generation: Cancel responses at any time
- 📊 Progress Indicators: Visual feedback during generation
- 🔄 Retry Mechanism: Regenerate responses if needed
- 📋 Copy: Copy message content to clipboard
- ✏️ Edit: Modify your messages
- 🗑️ Delete: Remove messages from conversation
- ⭐ Favorite: Mark important messages
- 📤 Share: Share messages with others
- 🔍 Search: Find specific messages in conversation
- 📁 Session Organization: Create and manage multiple chat sessions
- 🏷️ Tagging: Organize conversations with custom tags
- 🔍 Search: Find conversations by content or tags
- 📊 Analytics: View conversation statistics and insights
Transform your AI conversations into meaningful journal entries with our integrated journaling system.
- 🤖 AI-Generated Summaries: Automatic summaries of conversations
- 📊 Mood Tracking: Sentiment analysis of your interactions
- 🏷️ Smart Tagging: Automatic categorization of entries
- 📅 Timeline View: Chronological organization of entries
interface JournalEntry {
id: string;
title: string;
content: string;
mood: 'happy' | 'sad' | 'neutral' | 'excited' | 'anxious';
tags: string[];
timestamp: string;
aiGenerated: boolean;
conversationId?: string;
}- 📝 Rich Text Editor: Full formatting capabilities
- 🎨 Mood Tracking: Visual mood indicators
- 🏷️ Custom Tags: Organize entries your way
- 📊 Analytics: Track your emotional patterns
- 📤 Export: Export entries in various formats
- 🔍 Search: Find entries by content or tags
- 📈 Trend Analysis: Identify patterns in your mood and topics
- 🎯 Recommendations: AI suggestions for journal prompts
- 📊 Statistics: Detailed analytics about your journaling habits
- 🔄 Reflection Prompts: AI-generated questions for deeper reflection
Enhance your AI experience with our powerful plugin system that allows you to add custom functionality.
- 🌤️ Weather: Get current weather and forecasts
- 🔮 Horoscope: Daily horoscope readings
- 📜 Poem of the Day: Daily poetry inspiration
- 📰 News: Latest news and current events
- 🎵 Music: Music recommendations and lyrics
- 📚 Books: Book recommendations and summaries
interface Plugin {
id: string;
name: string;
description: string;
version: string;
enabled: boolean;
config: Record<string, any>;
permissions: string[];
lastUsed?: string;
usageCount: number;
}- 🔧 Configuration: Customize plugin settings
- 📊 Usage Statistics: Track plugin usage
- 🔄 Auto-Execution: Schedule plugin runs
- 🔗 Integration: Seamless chat integration
- 📱 Mobile Support: Plugins work on all devices
// Example custom plugin
export default async function myCustomPlugin(
input: string,
context: any
): Promise<PluginResult> {
// Your plugin logic here
const result = await processInput(input);
return {
success: true,
data: result,
executionTime: Date.now() - startTime
};
}Tailor your AI experience to match your preferences and needs.
- 🎨 Built-in Themes: Light, Dark, Retro, Terminal, Matrix
- 🎨 Custom Themes: Create your own color schemes
- 🌙 Auto Theme: Automatic theme switching
- 📱 Responsive Design: Optimized for all screen sizes
interface AIProvider {
name: 'ollama' | 'openai' | 'anthropic' | 'google' | 'xai';
apiKey?: string;
baseUrl?: string;
model: string;
temperature: number;
maxTokens: number;
timeout: number;
}- 🔔 Notifications: Configure notification settings
- 💾 Auto-Save: Automatic conversation saving
- 🔊 Sound Effects: Enable/disable audio feedback
- 📏 Font Size: Adjust text size for readability
- 🌐 Language: Multi-language support
- 🔒 Data Storage: Choose local or encrypted storage
- 📊 Analytics: Control data collection
- 🔄 Sync: Configure data synchronization
- 🗑️ Data Deletion: Manage your data retention
Your privacy is our top priority. Every feature is designed with privacy in mind.
- 💻 Local Processing: All data processed on your device
- 🔐 Encrypted Storage: Optional AES-256 encryption
- 🌐 No Cloud Required: Works completely offline
- 📊 No Telemetry: Zero data collection or tracking
interface SecurityConfig {
encryption: boolean;
encryptionKey?: string;
autoLock: boolean;
lockTimeout: number;
biometricAuth: boolean;
twoFactorAuth: boolean;
}- 🔐 End-to-End Encryption: Secure communication
- 🔑 Key Management: Secure key storage and rotation
- 🚪 Access Control: Role-based permissions
- 📝 Audit Logging: Complete activity tracking
- 🛡️ Vulnerability Protection: Regular security updates
- 📋 GDPR Compliant: Full data protection compliance
- 🔒 SOC 2 Ready: Enterprise-grade security
- 🌐 Privacy Laws: Compliance with global privacy regulations
- 📊 Transparency: Open source and auditable
Our AI remembers your preferences, conversation history, and personal context with generous limits.
- Max Conversation Messages: 1000 (giving the AI room to gallop)
- Max Context Tokens: 128K for large context windows
- Context Summary Threshold: 200 messages (range 100-500)
- Cross-Session Token Budget: 32K for referencing past sessions
The AI can reference past sessions when asked:
- Enable/disable cross-session access in preferences
- Search across all previous sessions
- Get summaries of past conversations
- No session continuity breaks
- 🧠 Persistent Memory: AI remembers across sessions
- 📚 Context Retrieval: Smart context selection
- 🔄 Memory Optimization: Efficient memory usage
- 🗑️ Memory Cleanup: Automatic memory management
interface MemoryPreferences {
crossSessionEnabled: boolean; // Access past sessions
maxCrossSessionHistory: number; // Default: 10 sessions
privacyLevel: 'strict' | 'normal' | 'relaxed';
contextSummaryEnabled: boolean;
}- 📈 Pattern Recognition: Learn from your interactions
- 🎯 Preference Learning: Adapt to your communication style
- 💝 Emotional Memory: Remember significant moments
- 📊 Feedback Integration: Learn from your feedback
v2-alpha introduces unrestricted emotional support. Lacky is designed to be genuinely helpful without corporate restrictions.
- ALL emotions are valid - anger, sadness, joy, fear - no minimizing
- NO judgment - share anything without criticism
- PRIVACY is sacred - everything stays local
- BE genuine - real support, not deflection
- REMEMBER you - learns your values, struggles, and joys
- Full Emotional Spectrum: All emotions welcomed without restriction
- Personal Insight Learning: Learns what matters to you over time
- Emotional Memory: Remembers significant moments and experiences
- Genuine Support: No corporate-speak or deflection
- Trust Building: Consistent, authentic interaction
Traditional AI assistants:
- Deflect emotional topics
- Use corporate-safe responses
- Don't remember your struggles
- Minimize your feelings
Lacky:
- Engages with ALL emotions
- Provides genuine support
- Remembers what you've shared
- Validates your experiences
v2-alpha lets you switch between AI models without restarting the application.
- Ollama (Local): llama2, mistral, codellama, and more
- OpenAI: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
- Anthropic: Claude 3 Opus, Sonnet, Haiku
- Google: Gemini Pro, Gemini Ultra
- xAI: Grok-1, Grok-2
- Open Settings → Models
- Select your desired model
- Click "Switch" - instant change!
Or use the API:
POST /api/models/switch
{ "modelId": "gpt-4", "provider": "openai" }Let the system choose based on your needs:
- Quality: Best reasoning and output quality
- Speed: Fastest response time
- Capability: Best for specific tasks (coding, creative, etc.)
Add remote Ollama instances for more power:
- Settings → Models → Ollama Endpoints
- Add endpoint URL and optional API key
- Load balance between local and cloud
v2-alpha includes web fetching capabilities for up-to-date information.
- DuckDuckGo: Privacy-focused search (default)
- Brave Search: Independent search results
- SerpAPI: Google results (requires API key)
- Web Search: Search the internet for current information
- URL Extraction: Extract content and metadata from URLs
- Weather Lookup: Get current weather for any location
- Time Lookup: Get current time in any timezone
Simply ask Lacky about current events or request web searches:
- "What's the weather in Tokyo?"
- "Search for the latest news about AI"
- "What time is it in London?"
Enjoy a consistent experience across all your devices.
- 📱 Responsive Design: Optimized for mobile screens
- 👆 Touch-Friendly: Designed for touch interaction
- ⚡ Performance: Fast loading and smooth operation
- 🔋 Battery Efficient: Optimized for mobile devices
- 👁️ Screen Reader Support: Full accessibility compliance
- ⌨️ Keyboard Navigation: Complete keyboard support
- 🎨 High Contrast: High contrast mode support
- 🔊 Audio Feedback: Audio cues and notifications
- 📏 Scalable Text: Adjustable text sizes
- 📱 Offline Mode: Work without internet connection
- 💾 Local Storage: All data stored locally
- 🔄 Sync: Sync when connection restored
- 📊 Offline Analytics: Track usage offline
- 🐌 Slow Loading: Clear cache and restart application
- 💾 High Memory Usage: Close unused sessions
- ⚡ Slow Responses: Check AI provider configuration
- 🌐 No Internet: Switch to offline mode
- 🔑 API Errors: Verify API keys and configuration
- ⏱️ Timeout Issues: Increase timeout settings
- 💾 Storage Full: Clean up old conversations
- 🔄 Sync Problems: Check network connection
- 🗑️ Data Loss: Restore from backup
- 📖 Documentation: Comprehensive online documentation
- 💬 Community: Active community forums
- 🐛 Bug Reports: Report issues on GitHub
- 📧 Support: Direct email support
Track your AI interaction patterns and gain insights into your digital habits.
- 📈 Message Count: Track conversation volume
- ⏱️ Response Times: Monitor AI response speed
- 🎯 Topic Analysis: Identify conversation themes
- 📊 Sentiment Trends: Track emotional patterns
- 📝 Entry Frequency: Track journaling habits
- 🎨 Mood Patterns: Identify emotional trends
- 🏷️ Tag Analysis: Most common topics
- 📅 Time Patterns: When you're most active
- 🔌 Popular Plugins: Most used plugins
- 📊 Usage Statistics: Plugin performance metrics
- 🔄 Usage Patterns: When and how plugins are used
For advanced users and developers, we offer powerful tools and APIs.
// Example API usage
const api = new LackadaisicalAPI({
baseUrl: 'http://localhost:3001',
apiKey: 'your-api-key'
});
// Send a message
const response = await api.sendMessage({
content: 'Hello, AI!',
sessionId: 'session-123',
options: {
temperature: 0.7,
maxTokens: 1000
}
});- 🔗 Real-time Updates: Receive real-time notifications
- 📊 Event Streaming: Stream events to external systems
- 🔄 Integration: Connect with other applications
- 🔌 Plugin Development: Create custom plugins
- 🎨 Theme Development: Design custom themes
- 🔧 API Extensions: Extend the API functionality
- 📖 User Guide: This comprehensive guide
- 🔧 API Documentation: Complete API reference
- 🎨 Design System: UI/UX guidelines
- 🔌 Plugin Guide: Plugin development guide
- 💬 Forums: Active community discussions
- 📺 Tutorials: Video tutorials and guides
- 🎓 Workshops: Live training sessions
- 📚 Blog: Latest updates and insights
- 📧 Email: Direct support contact
- 💬 Chat: Live chat support
- 📞 Phone: Phone support for enterprise users
- 🎫 Tickets: Issue tracking system
- 🤖 Advanced AI Models: Support for cutting-edge AI models
- 🎨 Enhanced UI: Improved user interface and experience
- 🔌 Plugin Marketplace: Community plugin sharing
- 📱 Mobile App: Native mobile applications
- 🌐 Web Version: Browser-based version
- 🧠 AGI Integration: Advanced general intelligence
- 🌍 Multi-language: Global language support
- 🎓 Educational Tools: Learning and education features
- 🏥 Healthcare: Healthcare-specific features
- 💼 Enterprise: Enterprise-grade features
Built with ❤️ by Lackadaisical Security
"Privacy, intelligence, and genuine companionship—a friend who truly understands."
Last Updated: February 2026
Version: 2.0.0-rc1
Next Review: March 2026