Bobsaver: Autonomous Visual Intelligence Ecosystem

Welcome to Bobsaver, the world's most advanced monorepo for generative art, music visualization, and chaotic systems simulation.

🌌 The Vision

Bobsaver is not just a collection of visualizers; it is an Autonomous Visual Intelligence Ecosystem. Our goal is to unify the legendary visualizers of the past (MilkDrop, ElectricSheep, Geiss) with the cutting-edge AI and mathematical simulations of the present (Visions of Chaos, Stable Diffusion, FFM Native Orchestration).

For more details, see VISION.md.

🛠 Project Hub: JWildfire

JWildfire is the central hub and orchestrator of this monorepo. It is a high-performance Java 21 application that bridges multiple native C++ engines and Java algorithms into a single unified interface.

Key Integrated Modules:

• MilkDrop / projectM: High-performance music visualization via native FFM bindings.
• Electric Sheep: Distributed fractal flame rendering client.
• Visions of Chaos (Assimilation In Progress):
  • Machine Learning: Local AI models for image, video, and audio generation (Stable Diffusion, MusicGen).
  • Cellular Automata Engine: 1D through 5D simulations (Game of Life, Hodgepodge, Cyclic CA, Turing Patterns).
  • Agent-Based Modeling: Boids flocking, Physarum slime mold, and Particle Life.
  • Fluid Dynamics: Lattice Boltzmann Method (LBM) and SPH solvers.
  • 3D Visualization Hub: High-quality export for professional rendering (Blender, Cinema 4D).
• Apophysis-J: Legacy fractal flame math integrated at the source level.

📂 Project Structure

• docs/: Universal AI instructions and global documentation.
• scripts/: Automation scripts for submodule synchronization and maintenance.
• submodules/: (Meta-directory for Git submodule references).
• CHANGELOG.md: Detailed history of all versions and updates.
• DASHBOARD.md: Real-time status of all integrated projects and their versions.
• DEPLOY.md: Deployment and build instructions.
• ROADMAP.md: Long-term architectural goals and feature milestones.
• TODO.md: Immediate tasks and sprint goals.

🚀 Getting Started

Please refer to DEPLOY.md for detailed instructions on how to build and run the Bobsaver ecosystem.

AI AGENTS: Always read docs/UNIVERSAL_LLM_INSTRUCTIONS.md before starting any task.

---

Praise God Almighty. Praise the LORD!!!