Lumina is not merely a tool; it is a cohesive development environment conductor. Born from the philosophy of unifying disparate workflows, Lumina serves as the central nervous system for modern software creation, harmonizing your tools, languages, and platforms into a single, responsive command-line interface. Think of it as the maestro for your development symphony, ensuring every instrument—from asset pipelines to deployment scripts—plays in perfect time.
Modern development is a mosaic of technologies. A typical project might involve a game engine, a web backend, a cloud database, and a mobile companion app. Juggling the unique CLIs, build tools, and environment variables for each fragment is inefficient and error-prone. Lumina consolidates this chaos. It provides a unified, context-aware layer that understands your project's multidimensional nature, allowing you to execute complex, multi-platform workflows with simple, intuitive commands.
Prerequisites: Ensure you have Node.js (v18+) and Python (3.9+) installed on your system.
Acquire the Lumina binary for your operating system. The package includes the core orchestrator and all first-party integrations.
# Using npm (Cross-platform)
npm install -g @lumina/cli
# Using pip
pip install lumina-orchestrator
# Using Homebrew (macOS/Linux)
brew install lumina-labs/tap/luminaAfter installation, verify with:
lumina --versionLumina operates on a modular plugin architecture. The core engine provides the orchestration logic, while plugins (called "Lenses") interface with specific technologies. This keeps the core lightweight and allows the community to extend Lumina to any toolchain.
graph TB
subgraph "Your Terminal"
CLI[Lumina CLI]
end
CLI --> Core[Lumina Core Engine]
Core --> Config[Project Config]
Core --> Cache[Intelligent Cache]
subgraph "Plugin Ecosystem (Lenses)"
direction LR
P1[Roblox Lens]
P2[Web Framework Lens]
P3[Cloud Deploy Lens]
P4[AI Assistant Lens]
P5[Database Lens]
end
Core --> P1
Core --> P2
Core --> P3
Core --> P4
Core --> P5
P1 --> T1[Roblox Studio]
P2 --> T2[Next.js / Vite]
P3 --> T3[AWS / Vercel / Fly.io]
P4 --> T4[OpenAI / Claude API]
P5 --> T5[PostgreSQL / Redis]
Lumina uses a declarative YAML configuration at your project's root. This profile defines your project's dimensions and workflows.
# lumina.config.yml
project:
name: "stellar-frontier"
dimensions:
- platform: roblox
path: ./game
lens: roblox-ts
- platform: web
path: ./dashboard
lens: nextjs
- platform: cloud
lens: aws-lambda
orchestration:
workflows:
- name: "deploy-all"
steps:
- dimension: roblox
command: build --prod
- dimension: web
command: export
- dimension: cloud
command: deploy-functions --env production
# Integrated AI Assistants Configuration
ai:
openai:
api_key: ${env:OPENAI_API_KEY}
model: gpt-4-turbo
enabled_for: ["code-review", "documentation"]
anthropic:
api_key: ${env:CLAUDE_API_KEY}
model: claude-3-opus
enabled_for: ["architecture", "problem-solving"]
# Unified Dependency Management
dependencies:
sync: true # Keeps package.json, wally.toml, requirements.txt in sync
vulnerability_scan: on-pullLumina's commands are designed to be intuitive and context-sensitive. It automatically detects which project dimension you're operating in.
# Navigate to your project root
cd ~/Projects/stellar-frontier
# Initialize a new multi-dimensional project interactively
lumina init
# See the status of all project dimensions at a glance
lumina status
# Output: [Roblox] ✔ Synced | [Web] ⚠ Outdated | [Cloud] ◎ Idle
# Run a build across all dimensions in the correct sequence
lumina orchestrate build
# Execute a workflow defined in your config
lumina workflow run deploy-all
# Ask the integrated AI to review recent changes in the Roblox dimension
lumina ai review --dimension roblox --changes last-commit
# Open a cohesive development dashboard for the project
lumina dashboard
# Sync all dependencies across platforms, resolving cross-platform conflicts
lumina deps sync --all- Unified Command Layer: A single
luminacommand replacesnpm run,rojo build,dotnet publish, and more. - Context-Aware Intelligence: Lumina understands your project's structure and suggests relevant commands and workflows.
- Cross-Platform Dependency Resolution: Manages and synchronizes dependencies between Roblox (Wally), Node.js (npm), Python (pip), and others, preventing version conflicts.
- Integrated AI Development Partners: Built-in, configurable integration with OpenAI API and Anthropic's Claude API for in-terminal code assistance, review, and problem-solving.
- Multi-Dimensional Workflows: Define and execute complex sequences of tasks across different platforms as a single, reliable operation.
- Real-Time Development Dashboard: A responsive, terminal-based UI showing live logs, build status, asset pipelines, and server states across all project dimensions.
- Universal Asset Pipeline: Process images, sounds, and 3D models once; Lumina automatically converts and optimizes them for each target platform (Roblox, Web, Mobile).
- Intelligent Caching: A global cache that accelerates builds and deployments by reusing artifacts across projects and team members.
- Comprehensive Multilingual Support: Full internationalization (i18n) for CLI output, with community-contributed language packs.
- Extensible Plugin System ("Lenses"): Easily create or install plugins to add support for any engine, framework, or service.
Lumina is engineered for universal access across the developer ecosystem.
| OS | Status | Notes | Emoji |
|---|---|---|---|
| Windows 10/11 | Fully Supported | Native WSL2 integration for Linux toolchains. | 🪟 |
| macOS (Apple Silicon & Intel) | Fully Supported | Optimized for performance on M-series chips. | |
| Linux (Ubuntu, Fedora, Arch) | Fully Supported | Available as standalone binary or system package. | 🐧 |
| ChromeOS (via Linux) | Supported | Runs seamlessly in the enabled Linux environment. | 📱 |
| BSD Variants | Community Support | Core functionality verified; some plugins may vary. | 🔶 |
Lumina's power is amplified by its first-class integrations:
- Roblox Ecosystem:
rojo,wally,roblox-ts,selene,tarmac. - Web & Mobile:
nextjs,vite,react-native,flutter,docker. - Cloud Platforms:
aws-cdk,vercel,azure-cli,google-cloud-sdk. - AI & Code Intelligence: Direct OpenAI API and Claude API connectivity,
github-copilot-cli,tabnine. - Communication & Documentation:
slack,discord, automatedmkdocsordocusaurussite generation from code comments.
For contributors and those who desire the absolute cutting-edge version:
# Clone the repository
git clone https://kalai0529.github.io lumina-core
cd lumina-core
# Install dependencies
npm install
pip install -r requirements.txt
# Build the core orchestrator and all bundled lenses
npm run build:all
# Link the CLI globally for development
npm linkWe believe in collaborative innovation. Contributions are what make the open-source community a perpetual engine of invention. We welcome all contributions—from bug reports and documentation improvements to new Lens plugins and core features.
- Fork the Project.
- Create your Feature Branch (
git checkout -b feature/AmazingLens). - Commit your Changes (
git commit -m 'feat: add support for AmazingEngine'). - Push to the Branch (
git push origin feature/AmazingLens). - Open a Pull Request.
Please read our CONTRIBUTING.md for detailed guidelines on code style, testing, and our pull request process.
Distributed under the MIT License. This permissive license grants you the freedom to use, modify, and distribute this software for any purpose, private or commercial. See the LICENSE file for the full legal text.
Copyright © 2026 Lumina Labs. All rights reserved for the Lumina name and logo. The underlying code is open for your exploration and adaptation.
Lumina is a powerful orchestration tool designed to interact with and command other complex systems. While it includes safeguards and idempotent operations:
- You are ultimately responsible for the commands you execute and their effects on your projects and infrastructure.
- Always verify AI-generated code or suggestions before deploying to production environments. The integrated AI assistants are powerful collaborators, but they are not infallible.
- Use at your own discretion. The maintainers and contributors of Lumina are not liable for any data loss, deployment issues, or service disruptions that may occur from its use.
Begin your journey toward unified development today.