hazelaura 2.0.1

HazelAura CLI for Discord bot scaffolding

HazelAura

HazelAura is a powerful CLI framework designed for scaffolding clean, scalable, and lightning-fast Discord bots using discord.py. Built by Crazy Pokeking, it provides an ultra-modern developer experience out of the box.

🚀 Features

• Instant Scaffolding: Create a fully structured Discord bot project with cogs, core utilities, and database placeholders in seconds.
• Hybrid Commands: Bots generated by HazelAura use Hybrid Commands out of the box, allowing users to execute commands via both traditional prefixes (!) and modern slash commands (/).
• Dev Mode Hot-Reloading: Run your bot with aura run dev and it will automatically reboot the moment you save a file, thanks to built-in watchfiles integration.
• Lightning-Fast Installs: Uses uv under the hood to install dependencies 10x-100x faster than standard pip.
• Auto-Discovery Dependency Installation: Run aura install and Aura uses AST scanning to automatically detect external imports in your code, install them, and append them to requirements.txt. It even interactively learns PyPI package names if they differ from import names (e.g. mapping pyray to raylib).
• Built-in Security Audits: Run aura scan to automatically detect and optionally fix vulnerabilities in your bot's dependencies using pip-audit.
• Low-Latency Loop: Automatically detects your OS and applies uvloop in production (on Linux/macOS) for a 2-4x speedup in event processing.

📦 Installation

pip install hazelaura

🛠️ Usage & Commands

# Create a new bot project
aura create --project my_bot

# Navigate into your new bot project
cd my_bot

# Create a new Cog (must be run inside the /cogs folder)
cd cogs
aura create --cog economy
cd ..

# Automatically scan all .py files, resolve missing dependencies, and install them
aura install

# Install a specific module and save it to requirements.txt
aura install requests

# Run the bot in Dev Mode (with Hot-Reloading)
aura run dev

# Scan your dependencies for known security vulnerabilities
aura scan

# Automatically attempt to fix security vulnerabilities
aura scan --fix

🌐 Author

Created with ❤️ by Crazy Pokeking.