{"id":29430796,"url":"https://github.com/zenthcloud/lab-bot","last_synced_at":"2026-05-19T06:08:42.062Z","repository":{"id":301165519,"uuid":"1008373211","full_name":"zenthcloud/lab-bot","owner":"zenthcloud","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-25T13:20:12.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T13:49:34.236Z","etag":null,"topics":["api","discord-js","javascript","lab","proxmox","tools","zenthcloud"],"latest_commit_sha":null,"homepage":"https://discord.gg/zenthcloud","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zenthcloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-25T12:50:42.000Z","updated_at":"2025-06-25T13:20:16.000Z","dependencies_parsed_at":"2025-06-25T13:59:39.552Z","dependency_job_id":null,"html_url":"https://github.com/zenthcloud/lab-bot","commit_stats":null,"previous_names":["zenthcloud/lab-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zenthcloud/lab-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenthcloud%2Flab-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenthcloud%2Flab-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenthcloud%2Flab-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenthcloud%2Flab-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zenthcloud","download_url":"https://codeload.github.com/zenthcloud/lab-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zenthcloud%2Flab-bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265031479,"owners_count":23700845,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","discord-js","javascript","lab","proxmox","tools","zenthcloud"],"created_at":"2025-07-12T18:02:00.865Z","updated_at":"2026-05-19T06:08:37.023Z","avatar_url":"https://github.com/zenthcloud.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zenth Lab Discord Bot\n\nThe **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.\n\n---\n\n## ✨ Features\n\n- 🚀 Launch cyber labs and training environments via Discord commands\n- 🔒 Role-based access and user authentication\n- 🧪 Integration with Zenth Cloud infrastructure (Proxmox, Docker, Kubernetes)\n- ⏳ Automatic lab expiration and lifecycle control\n- 📡 Real-time status updates and logs\n- 🧠 Designed for education, pentesting, and research communities\n\n---\n\n## 💬 Available Commands\n\n| Command | Description |\n|--------|-------------|\n| `/lab launch [lab_name]` | Launch a predefined lab |\n| `/lab list` | List all available labs |\n| `/lab status [lab_id]` | Check the status of an active lab |\n| `/lab stop [lab_id]` | Stop a running lab manually |\n| `/lab help` | Get help on usage |\n\n---\n\n## 🏗 Architecture\n\n- **Bot Framework**: `discord.py` or `discord.js`\n- **API Backend**: Connects to `zenth-cyber-orchestrator` for infrastructure provisioning\n- **Cloud Providers**: Integrates with Zenth Container Server, Proxmox, Kubernetes\n- **SSO \u0026 Access**: Uses Zenth SSO or Discord roles for access control\n- **Monitoring**: Connected to Zenth Monitoring Server\n\n---\n\n## 🧰 Requirements\n\n- Python 3.10+ or Node.js 18+\n- Discord Bot Token\n- Access to Zenth Cloud API\n- Optional: VPN or proxy access to internal infrastructure\n\n---\n\n## 🚀 Getting Started\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/zenthcloud/lab-bot.git\ncd lab-bot\n````\n\n2. Set up your environment variables:\n\n```env\nDISCORD_BOT_TOKEN=your_token_here\nZENTH_API_URL=https://api.zenthcloud.com/labs\nZENTH_API_KEY=your_api_key_here\n```\n\n3. Install dependencies and run the bot:\n\n```bash\n# Node.js version\nnpm install\nnode index.js\n```\n---\n\n## 📚 Use Cases\n\n* Cybersecurity training (Kali Linux, CTFs, pentest labs)\n* Educational environments for schools or universities\n* Research \u0026 development on cloud security\n* Discord-integrated community labs (HTB-style)\n\n---\n\n## 🔗 Links\n\n* 🔗 Zenth Cloud: [Website](https://zenthcloud.com)\n* 🔧 Zenth Cyber Orchestrator: `zenth-cyber-orchestrator`\n* 📦 Zenth Container Server: `zenth-container-server`\n* 📚 Labs and curriculum: `zenth-network-academic`\n\n---\n\n## 🛡 License\n\nThis project is licensed under the **AGPLv3**. See [LICENSE](./LICENSE) for details.\n\n---\n\n## 🤝 Contributing\n\nWe welcome community contributions! Please open issues, submit PRs, or join the discussion on [Discord](https://discord.gg/zenthcloud) or Matrix.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzenthcloud%2Flab-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzenthcloud%2Flab-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzenthcloud%2Flab-bot/lists"}