🩸 LuciferAI Playground

Interactive Web Demo — Try LuciferAI directly in your browser

A fully-functional web-based simulation of LuciferAI_Local, demonstrating the self-healing terminal assistant, fallback tiers, and FixNet capabilities.

Live Demo: https://luciferai-playground.pages.dev

---

🎯 What is This?

The LuciferAI Playground is an interactive terminal simulator that lets you experience LuciferAI without installation. It:

✅ Pulls live data from the LuciferAI_Local repository
✅ Displays real demo scripts from the Demo/ folder
✅ Shows current model tiers and capabilities
✅ Simulates the 5-tier fallback system
✅ Demonstrates auto-fix workflows

---

✨ Features

Live Repository Integration

The playground automatically syncs with the main LuciferAI_Local repository to show:

• Latest commit information (SHA, author, date)
• Real demo scripts from the Demo/ folder
• Current model tiers from the README
• Repository statistics (stars, forks, issues)

Interactive Commands

Try these commands in the playground terminal:

📂 Repository Commands (NEW!)

demos                # List all demo scripts from GitHub
view <filename>      # View a demo file's content
repo status          # Show repository info and latest commit
sync                 # Refresh data from GitHub

🤖 LLM Commands

llm list             # Show model tiers (live from repo)
models info          # Model tier system info
what is python?      # Ask questions (simulated response)

🔧 System Commands

fallback test        # Demo the 5-tier fallback system
fixnet stats         # FixNet statistics
fixnet sync          # Sync with FixNet

📜 Script Commands

run demo.py          # Run a script (simulated)
fix broken.py        # Auto-fix with step-by-step output
create file test.py  # Create a script template

🎮 Fun Commands

badges               # Show badge collection
soul                 # Check soul status
session              # Session information

---

🚀 How It Works

1. Repository Sync Module (repo-sync.js)

Fetches live data from GitHub using:

• GitHub API for directory listings and repo stats
• Raw GitHub content for file contents
• 5-minute caching to respect rate limits

2. Command Simulator (lucifer-sim.js)

Simulates LuciferAI commands with:

• Realistic output matching the real system
• Step-by-step demonstrations
• Syntax highlighting for code
• Multi-tier model routing simulation

3. Terminal Interface (terminal.js)

Uses xterm.js for:

• Full ANSI color support
• Command history (Up/Down arrows)
• Tab autocomplete
• Keyboard shortcuts (Ctrl+C, Ctrl+L)

---

🎨 Architecture

LuciferAI_Playground/
├── index.html              # Main page
├── css/
│   └── terminal.css        # Terminal styling
├── js/
│   ├── repo-sync.js        # GitHub integration (NEW!)
│   ├── lucifer-sim.js      # Command simulator (UPDATED!)
│   ├── terminal.js         # Terminal controller
│   ├── fallback-demo.js    # Fallback tier demo
│   └── os-paths.js         # OS-specific paths
├── models/                 # Model placeholders
└── README.md              # This file

---

🔄 Staying Synced with Main Repo

The playground automatically stays up-to-date with LuciferAI_Local:

Automatic Sync (Every Page Load)

1. Fetches latest README.md
2. Lists Demo/ folder contents
3. Gets latest commit info
4. Updates repo statistics

Manual Sync (User Triggered)

sync                 # Force refresh from GitHub

What Gets Synced

• ✅ Model tier information from README
• ✅ Demo script listings
• ✅ Demo file contents (on-demand)
• ✅ Latest commit SHA and message
• ✅ Repository stars, forks, issues

What's Simulated

• ❌ Actual LLM inference (responses are templated)
• ❌ File system operations (simulated)
• ❌ Real script execution (output is mocked)

---

🛠️ Development

Local Setup

1. Clone the repository:

   git clone https://github.com/GareBear99/LuciferAI_Playground.git
   cd LuciferAI_Playground

2. Serve locally:

   # Python 3
   python3 -m http.server 8000
   
   # Or Node.js
   npx http-server -p 8000

3. Open browser:

   http://localhost:8000
   

Testing Repository Sync

# Open browser console (F12) and check:
console.log(window.RepoSync.cache);

You should see:

• readme - Parsed README data
• demoFiles - Array of demo scripts
• lastFetch - Timestamp of last sync

Adding New Commands

1. Add command handler in lucifer-sim.js:

   case 'mycommand':
       return this.myCommandOutput();

2. Implement output function:

   myCommandOutput() {
       return [
           '',
           '\\x1b[35mMy Command Output\\x1b[0m',
           '\\x1b[2m─────────────────\\x1b[0m',
           ''
       ];
   }

3. Update help command to include your new command

---

📊 Cloudflare Pages Deployment

The playground is automatically deployed to Cloudflare Pages:

Deployment Process

1. Push to master branch
2. Cloudflare Pages automatically builds and deploys
3. Live at: https://luciferai-playground.pages.dev

Manual Deployment

# Commit changes
git add .
git commit -m "Update playground"
git push origin master

# Cloudflare Pages will auto-deploy in ~1 minute

---

🌐 Browser Compatibility

Tested on:

• ✅ Chrome 90+
• ✅ Firefox 88+
• ✅ Safari 14+
• ✅ Edge 90+

Note: Requires JavaScript enabled for full functionality.

---

🔗 Related Projects

Project	Description	Link
LuciferAI_Local	Main project - fully local AI terminal assistant	GitHub
LuciferAI_FixNet	Collaborative fix repository	GitHub
LuciferAI_Playground	This project - web demo	GitHub

---

💡 Why a Playground?

Benefits

1. Zero Installation - Try before you install
2. Instant Access - No setup, no dependencies
3. Always Updated - Pulls latest features from repo
4. Shareable - Send link to anyone
5. Educational - See how LuciferAI works

Limitations

• No Real LLM - Responses are simulated
• No File System - Operations are mocked
• No Persistence - Session resets on refresh
• Network Required - Needs GitHub API access

---

🤝 Contributing

Contributions welcome! Please:

1. Fork the repo
2. Create a feature branch
3. Test locally
4. Submit a pull request

Areas for Improvement

• Better syntax highlighting
• More realistic LLM response simulation
• Save/share terminal sessions
• Mobile-optimized layout
• Dark/light theme toggle

---

📜 License

MIT License - Same as LuciferAI_Local

---

🙏 Acknowledgments

• Built with xterm.js
• Inspired by Warp Terminal
• Part of the LuciferAI ecosystem

---

📞 Support

• 🐛 Report Issues
• 💬 Discussions
• ❤️ Sponsor

---

Made with 🩸 by LuciferAI

"Forged in Silence, Born of Neon."