Home

Luna Chat Documentation

Welcome to the Luna Chat documentation wiki! Luna is a local-first, privacy-focused autonomous AI companion with a Council of sub-agents, long-term memory, and full system integration.

Quick Navigation

Getting Started

• Getting Started - Installation and setup guide
• Configuration - Environment and model configuration
• Docker Deployment - Docker-specific setup

Core Features

• Chat Modes - Assistant, Companion, and Voice modes
• Luna's Abilities - Complete list of tools and capabilities
• Memory System - How Luna remembers you

Advanced Features

• Council and Friends - Multi-AI deliberation system
• Autonomous Mode - Self-directed operation
• Agents - Specialized task agents
• Trading - Trader Luna and Binance integration

Integrations

• Calendar Integration - CalDAV setup
• Email Integration - SMTP/IMAP configuration
• Telegram Integration - Telegram bot for mobile notifications
• MCP Integration - Model Context Protocol external tools
• LLM Providers - Supported AI providers

Development

• API Reference - Complete API documentation
• Architecture - System architecture overview
• Security - Security features and best practices
• Development Guide - Contributing and development

---

What is Luna?

Luna Chat v7 is a comprehensive AI Operating System designed for privacy and autonomy. Unlike standard chatbots, Luna features:

Council Architecture

Multiple sub-agents (Polaris, Aurora, Vega, Sol) deliberate in the background to provide thoughtful, well-rounded responses.

Local-First Design

Built to run entirely on local hardware with Ollama - your data never leaves your machine.

Deep Integration

• Code execution sandbox
• Calendar management (CalDAV)
• Email (SMTP/IMAP)
• Spotify music control
• Document processing
• Web search

Long-term Memory

Luna remembers facts, preferences, and conversation history with vector embeddings. NEW: MemoryCore integration provides three-tier memory consolidation (Working → Episodic → Semantic) with NeuralSleep LNN processing and consciousness metrics.

---

Feature Comparison

Feature	Standard AI	Luna
Memory	Session-only	Long-term facts and preferences
Thinking	Single response	Council deliberation
Relationships	None	AI friends who discuss insights
Actions	Text only	Code, calendar, email, files, music
Privacy	Cloud-dependent	100% local capable
Personality	Generic	Customizable with mood tracking

---

Quick Start

# Clone
git clone https://github.com/bitwarelabs/luna-chat.git
cd luna-chat

# Create secrets
mkdir -p secrets
echo "your-password" > secrets/postgres_password.txt
echo "your-jwt-secret" > secrets/jwt_secret.txt
echo "your-redis-password" > secrets/redis_password.txt

# Start
docker compose build
docker compose up -d

Access Luna at http://localhost:3004

---

Support

• GitHub Issues - Bug reports and feature requests
• Discussions - Community discussions