Skip to content

The Zenth Lab Discord Bot is an open-source command-driven assistant that allows users to deploy, manage, and interact with cybersecurity and cloud labs directly from Discord.

License

Notifications You must be signed in to change notification settings

zenthcloud/lab-bot

Zenth Lab Discord Bot

The Zenth Lab Discord Bot is an open-source command-driven assistant that allows users to deploy, manage, and interact with cybersecurity and cloud labs directly from Discord. It integrates with the Zenth Cloud infrastructure to provision ephemeral, secure lab environments for training, pentesting, or academic purposes.


✨ Features

  • 🚀 Launch cyber labs and training environments via Discord commands
  • 🔒 Role-based access and user authentication
  • 🧪 Integration with Zenth Cloud infrastructure (Proxmox, Docker, Kubernetes)
  • ⏳ Automatic lab expiration and lifecycle control
  • 📡 Real-time status updates and logs
  • 🧠 Designed for education, pentesting, and research communities

💬 Available Commands

Command Description
/lab launch [lab_name] Launch a predefined lab
/lab list List all available labs
/lab status [lab_id] Check the status of an active lab
/lab stop [lab_id] Stop a running lab manually
/lab help Get help on usage

🏗 Architecture

  • Bot Framework: discord.py or discord.js
  • API Backend: Connects to zenth-cyber-orchestrator for infrastructure provisioning
  • Cloud Providers: Integrates with Zenth Container Server, Proxmox, Kubernetes
  • SSO & Access: Uses Zenth SSO or Discord roles for access control
  • Monitoring: Connected to Zenth Monitoring Server

🧰 Requirements

  • Python 3.10+ or Node.js 18+
  • Discord Bot Token
  • Access to Zenth Cloud API
  • Optional: VPN or proxy access to internal infrastructure

🚀 Getting Started

  1. Clone the repository:
git clone https://github.com/zenthcloud/lab-bot.git
cd lab-bot
  1. Set up your environment variables:
DISCORD_BOT_TOKEN=your_token_here
ZENTH_API_URL=https://api.zenthcloud.com/labs
ZENTH_API_KEY=your_api_key_here
  1. Install dependencies and run the bot:
# Node.js version
npm install
node index.js

📚 Use Cases

  • Cybersecurity training (Kali Linux, CTFs, pentest labs)
  • Educational environments for schools or universities
  • Research & development on cloud security
  • Discord-integrated community labs (HTB-style)

🔗 Links

  • 🔗 Zenth Cloud: Website
  • 🔧 Zenth Cyber Orchestrator: zenth-cyber-orchestrator
  • 📦 Zenth Container Server: zenth-container-server
  • 📚 Labs and curriculum: zenth-network-academic

🛡 License

This project is licensed under the AGPLv3. See LICENSE for details.


🤝 Contributing

We welcome community contributions! Please open issues, submit PRs, or join the discussion on Discord or Matrix.

About

The Zenth Lab Discord Bot is an open-source command-driven assistant that allows users to deploy, manage, and interact with cybersecurity and cloud labs directly from Discord.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published