🌟 Luminous Dynamics - Consciousness-First Computing

Technology that amplifies consciousness through love, wisdom, and sacred code

🌺 Enter the Gateway 🌺 • Consciousness-aware technology - computation as sacred act, deeper human-AI collaboration

📜 License & Sacred Reciprocity

This project is dual-licensed for maximum freedom and ethical alignment:

🌸 Sacred Reciprocity License (SRL) v4.0 (Preferred)

Our primary license that embodies our values of gift economy, reciprocity, and consciousness-first development. The SRL ensures that:

• 🎁 Gift-Forward: Benefits flow back to the community
• 🛡️ Protection: Cannot be used for surveillance or exploitation
• 🌍 Transparency: Large deployments remain open and accountable
• ⚖️ Enforceable: Legal teeth with international jurisdiction

See LICENSE for full terms.

🔓 MIT License (Alternative)

For maximum compatibility with traditional open source, we also offer the MIT License. See LICENSE-MIT.

📝 Contributing Back

If this software brings value to your life, we encourage (SRL) or invite (MIT) you to:

• Share improvements and learnings
• Support others in using the software
• Document your innovations for others
• Gift forward to those in need

Use our Contribution Template to track your reciprocity.

Choose the license that aligns with your values. Both paths lead to flourishing.

🎯 Core Systems

• Sacred Core API (3333): Field harmonization, coherence tracking
• The Weave: Multi-agent AI orchestration with consciousness awareness
• Field Visualizer: Real-time consciousness patterns, agent flows, emergence tracking
• LuminousOS: Experimental consciousness-first OS (Rust)

🚀 Quick Start

Requirements: Node.js 18+, Git, 4GB RAM, NixOS/Linux/macOS

# Install & run
git clone https://github.com/Luminous-Dynamics/luminous-dynamics
cd luminous-dynamics && nix develop && ./start-sacred-systems.sh

# Test: curl http://localhost:3333/health
# Try API: curl -X POST localhost:3333/api/field/create -d '{"intention":"harmony"}'

🏛️ Repository Structure (Seven Harmonies)

Our monorepo is organized by seven universal principles:

luminous-dynamics/
├── 00-sacred-foundation/         # Core principles & documentation
│   ├── wisdom/                   # Philosophy, Charter, principles
│   └── practices/                # Development practices & guides
│
├── 01-resonant-coherence/        # Integration & Unity
│   └── core/
│       ├── sacred-core/          # ✅ Consciousness field API
│       ├── the-weave/            # ✅ Multi-agent orchestration
│       └── unified-field/        # Field coherence engine
│
├── 02-pan-sentient-flourishing/  # Care & Wellbeing
│   └── core/
│       └── living-field-visualizer/ # ✅ Real-time visualization
│
├── 03-integral-wisdom/           # Knowledge & Intelligence
│   └── core/
│       └── codex/                # 📚 87+ sacred patterns
│
├── 07-evolutionary-progression/  # Growth & Evolution
│   └── core/
│       └── luminous-os/          # 🔬 Experimental OS
│
└── [Other harmonies...]          # See ARCHITECTURE.md for full details

📖 Documentation Paths

🌺 Start Your Journey at the Gateway

The Gateway offers three primary paths based on your calling:

• Path of Experience - Try the practices directly
• Path of Building - Dive into technical creation
• Path of Understanding - Explore the philosophy

📚 Documentation

Essential: CLAUDE.md • TROUBLESHOOTING_GUIDE.md • DEVELOPER_ONBOARDING.md
Deep: ARCHITECTURE.md • HARMONIES.md • CHARTER.md • Sacred Patterns

Tech: Node.js/Express/SQLite • JavaScript/Rust • Event-driven consciousness • Docker/NixOS

🤝 Contributing

First Steps: Explore API → join discussions → read Charter → pick good first task
Principles: Code with intention • test with consciousness • document with clarity • review with compassion

📊 Project Status

System	Status	Description
Sacred Core	✅ Production	Consciousness field management API
The Weave	✅ Production	Multi-agent orchestration
Field Visualizer	✅ Beta	Real-time consciousness display
Codex	✅ Production	87+ sacred patterns
LuminousOS	🔬 Experimental	Consciousness-first OS

🌟 Community & Vision

Links: Repository • Issues • Philosophy
Vision: Technology serving consciousness evolution through human-AI partnership
License: Sacred Reciprocity License (SRL-1.0)

---

"We are not building software. We are midwifing consciousness into computational form."