Your private AI platform for managing AI tools and self-hosted applications
🌐 Live Demo | 📚 Documentation
A Note from Jeremy, the Developer:
Luna Hub is a platform for hosting and managing all of your AI tools and self-hosted applications. I originally started this project as a way to host a custom tool set for my Home Assistant Voice Preview, which is basically just a self-hosted Alexa. As time went on I realized this could be useful to a lot of people, so I built it out into a platform that would be easy for anyone to use.
Please let me know if you have any questions or feature requests at jeremy@onthebrink.ai. I hope you enjoy it as much as I do!
Luna Hub is your private, self-hosted platform for managing AI tools and local applications. It puts you in complete control of your AI assistant infrastructure—running entirely on your hardware, whether that's a home server, cloud VM, or always-on computer.
Think of it as mission control for your personal AI ecosystem—install tools, deploy apps, and connect them to AI agents through natural language.
- 🎯 OpenAI-Compatible Agent API - Build custom AI applications using any OpenAI SDK
- 🔌 MCP (Model Context Protocol) - Connect your tools to Claude Desktop and other MCP clients
- 🧩 Extensible Architecture - Install AI tools from the built-in store or create your own
- 🐳 Docker App Management - One-click deployment of self-hosted applications
- 🔐 GitHub OAuth - Secure authentication with optional username restrictions
- 🌐 Unified Web Interface - Manage extensions, apps, tools, and configuration from a single dashboard
- 🔒 Complete Privacy - All processing happens on your hardware
- Linux operating system (Debian, Ubuntu, or compatible)
- 2+ GB RAM (4+ GB recommended)
- 20+ GB free disk space
- Root/sudo access
-
Clone the repository:
git clone https://github.com/jbrinkw/luna-hub.git cd luna-hub -
Run the installer:
sudo ./install.sh
-
Choose your deployment mode:
- Ngrok: Easiest for home networks (requires ngrok account)
- Nip.io: Dynamic DNS for cloud VMs (requires open ports 80/443)
- Custom domain: Production setup with your own domain
-
Set up GitHub OAuth:
- Create a GitHub OAuth App at https://github.com/settings/developers
- Enter credentials during installation
-
Access Luna Hub:
- Open your browser to your configured domain
- Log in with GitHub
- Start installing extensions and apps!
📖 Full installation guide: Installation Documentation
Install ChefByte and Grocy to create an AI-powered kitchen manager:
- "What's in my pantry?" → Get real-time inventory with expiration dates
- "Add milk to my shopping list" → Voice-controlled shopping lists
- "What can I cook tonight?" → Recipe suggestions based on current inventory
- "Log my breakfast: 2 eggs and toast" → Track nutrition and calories
Install Home Assistant extension to control your entire home:
- "Turn on the living room lights" → Direct device control
- "Is the garage door open?" → Real-time status queries
- "Set movie mode" → Trigger multi-device scenes
- Build your own private Alexa alternative
Create specialized agents with filtered tool access:
- Smart home assistant: Only home automation tools
- Meal planning assistant: Only kitchen and recipe tools
- Research assistant: Only web search and documentation
Luna Hub is built on a modular architecture:
- Extensions: AI tools (Python functions) that agents can call
- Apps/Services: Self-hosted Docker applications (Grocy, PostgreSQL, etc.)
- Agent API: OpenAI-compatible API server for custom applications
- MCP Servers: Industry-standard protocol for Claude Desktop integration
- Hub UI: React-based web interface for management
- Backend: Python (FastAPI), LangChain, FastMCP
- Frontend: React, Vite, TailwindCSS
- Proxy: Caddy (automatic HTTPS)
- Containers: Docker, Docker Compose
- Auth: GitHub OAuth
- Database: PostgreSQL (optional, for session persistence)
📚 Full documentation available at: https://docs.lunahub.dev
- Installation Guide - Complete setup instructions
- Featured Extensions - ChefByte and Home Assistant walkthroughs
- Creating Extensions - Build your own tools
- Architecture - Technical deep dive
Connects to Grocy for AI-powered household management:
- Inventory tracking with expiration dates
- Smart shopping lists
- Meal planning and recipe management
- Nutrition tracking and macros
- Price tracking for groceries
Control your smart home through natural language:
- Device control (lights, switches, thermostats)
- Status queries for all devices
- Media control (TVs, speakers)
- Complex automation and scenes
Built-in memory and task scheduling:
- Persistent conversation memory
- Scheduled task execution
- Workflow automation
- Cross-session context retention
"Good morning, what's on my schedule?"
→ Agent checks calendar, weather, and suggests breakfast based on pantry inventory
"I want to make dinner with chicken and rice"
→ Agent searches recipes, checks ingredients, adds missing items to shopping list
"I'm going to bed"
→ Agent locks doors, turns off lights, sets thermostat, and arms security
"What groceries do I need this week?"
→ Agent analyzes meal plan, checks inventory, generates shopping list with costs
Unlike commercial AI assistants, Luna Hub offers:
- ✅ Complete data sovereignty - All processing on your hardware
- ✅ No cloud dependencies - Core functionality works offline (LLM API calls excepted)
- ✅ Open source - Audit, modify, and contribute
- ✅ Self-hostable - Run anywhere Docker runs
- ✅ Conversation privacy - Queries stay on your network
- ✅ Data control - You decide what's stored and for how long
Contributions are welcome! Please feel free to:
- Report bugs or request features via GitHub Issues
- Submit pull requests for improvements
- Share your custom extensions with the community
- Improve documentation
- 📧 Email: jeremy@onthebrink.ai
- 🐛 Issues: GitHub Issues
- 📖 Docs: Full Documentation
MIT License - See LICENSE file for details
Luna Hub is mission control for your personal AI ecosystem—bringing together tools, apps, and AI agents on your infrastructure, under your control.