🎉 Magi Ecosystem v1.0.0 - The Chamber Awakens!
What's New?
With this release, we're introducing a groundbreaking rearchitecture of the Magi CLI ecosystem, bringing modularity, scalability, and enhanced usability to your command-line magic. Magi.Chamber and Magi.Spells now power the CLI as separate entities, laying the foundation for an ever-growing library of spells.
Magi.Library: The Unified Parent
Learn all about the new structure of the Magi ecosystem in the Magi.Library repository. This parent repository serves as the central hub for understanding the architecture, linking the key components of the system:
- Magi.Chamber: The spell repository server.
- Magi.Spells: A growing collection of spells to enhance your magical prowess.
- Magi CLI: Your command-line interface for wielding all this magic.
Modular Spellcasting with Magi.Chamber and Magi.Spells
The Magi CLI has evolved into a modular tool, with Magi.Chamber acting as the server that serves spells dynamically from the Magi.Spells repository.
What is Magi.Chamber?
Magi.Chamber (repo here) is the heart of the Magi ecosystem, hosting spells that the CLI can dynamically fetch. It provides:
- Dynamic Spell Syncing: Use
cast ponder
to sync your entire Grimoire or fetch individual spells on demand.
- Health and Manifest Endpoints: Check server status or retrieve metadata for all spells.
- Webhook-Triggered Syncs: Magi.Chamber stays updated with Magi.Spells via CI/CD pipelines triggered on commits to the main branch.
What is Magi.Spells?
Magi.Spells (repo here) is a dedicated repository for storing all spells. This structure enables:
- Simplified Spell Management: Spells are now version-controlled, allowing easy updates and contributions.
- Collaboration: Developers can contribute new spells, which are reviewed and approved by admins before being deployed.
- Autosyncing with Magi.Chamber: Any approved updates are automatically pushed to Magi.Chamber for immediate use.
How Spell Retrieval Works
Magi CLI users can manage their spells dynamically using cast ponder
. The backend handles syncing between Magi.Spells and Magi.Chamber effortlessly.
Workflow Overview:
- Admins Update Magi.Spells:
- New spells or updates are added to Magi.Spells and reviewed by admins.
- Approved updates are automatically deployed to Magi.Chamber via CI/CD pipelines.
- Users Retrieve Spells:
- Run
cast ponder
to sync your Grimoire or fetch individual spells from Magi.Chamber.
- Spells are always up-to-date with the latest approved versions.
This workflow ensures a seamless experience for both spell creators and users, fostering collaboration while maintaining control over quality.
Key Features in This Release
New Spells Framework
- Spells are no longer hardcoded into the CLI, enabling flexible and dynamic updates.
- Developers can now contribute directly to Magi.Spells, expanding the ecosystem.
Dynamic Spell Management
Use cast ponder
to:
- Sync your entire Grimoire with the latest spells from Magi.Chamber.
- Retrieve specific spells as needed.
Pagecraft: Markdown-Driven Landing Pages
- The
cast pagecraft
spell lets you transmute Markdown into beautiful, blog-like landing pages.
- Includes support for Bootstrap and customizable templates.
- Perfect for quickly generating project documentation or showcasing magical creations.
How to Upgrade
Upgrade your Magi CLI to the latest version:
pip install magi-cli-pypi --upgrade
Contributing
Want to create new spells? Here's how:
- Fork the Magi.CLI repository.
- Add your spell following the contribution guidelines.
- Add your functioning spell to the Magi.Spells repo under the
magi_cli/spells/
directory.
- If a spell is added to Magi.Spells, it will be automatically deployed to Magi.Chamber.
- If you create a pull request in Magi.CLI, it will be archived and a new PR will be created in Magi.Spells with your spell.
- Submit a pull request for admin review.
- Once approved, your spell becomes available in Magi.Chamber for everyone to use.
Thank You
This release marks a major milestone for the Magi ecosystem. With modular spell management, dynamic updates, and community collaboration, Magi CLI is now more powerful than ever.
May your spells be flawless, your pages beautifully crafted, and your CLI adventures magical! 🧙♂️✨