RayExo/ZyroX-CV2-AIO-With-Dashboard: self-hosted tool for developers and homelabbers

███████╗██╗   ██╗██████╗  ██████╗ ██╗  ██╗
╚══███╔╝╚██╗ ██╔╝██╔══██╗██╔═══██╗╚██╗██╔╝
  ███╔╝  ╚████╔╝ ██████╔╝██║   ██║ ╚███╔╝
 ███╔╝    ╚██╔╝  ██╔══██╗██║   ██║ ██╔██╗
███████╗   ██║   ██║  ██║╚██████╔╝██╔╝ ██╗
╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝

✦ Overview

ZyroX is a fully-featured Discord bot with a modern web dashboard for managing everything from antinuke to music. Built on discord.py v2, FastAPI, and Next.js 14 with Tailwind CSS.

ZyroX-CV2-With-Dashboard/
├── 🤖  bot/                   Python Discord bot + FastAPI backend
│   ├── api/                   Dashboard REST API (FastAPI)
│   ├── cogs/                  All bot features (commands, events, antinuke, automod…)
│   ├── core/                  Bot client, context, cog base
│   ├── utils/                 Shared utilities (emoji, tools, sync, cloudflare tunnel…)
│   ├── games/                 Standalone game modules
│   ├── assets/                Fonts, backgrounds, GIFs
│   └── CodeX.py               Entry point
│
└── 🌐  dashboard/             Next.js frontend
    ├── app/                   App Router pages & API routes
    ├── components/            Reusable UI components
    ├── hooks/                 Custom React hooks
    ├── lib/                   API helpers & utilities
    └── types/                 TypeScript type definitions

✦ Features

✦ Prerequisites

✦ Bot Setup

1 — Clone the repo

git clone https://github.com/RayExo/ZyroX-CV2-With-Dashboard
cd ZyroX-CV2-With-Dashboard/bot

2 — Install dependencies

python -m venv .venv

.venv\Scripts\activate

# Linux / macOS
source .venv/bin/activate

pip install -r requirements.txt

3 — Configure the environment

Copy .env.example to .env and fill in the values:

# ── Core ──────────────────────────────────────────────────────────
TOKEN              = your_discord_bot_token
brand_name         = 'ZyroX'

# ── Owner IDs (comma-separated) ───────────────────────────────────
OWNER_IDS          = 870179991462236170,767979794411028491

# ── Lavalink ──────────────────────────────────────────────────────
LAVALINK_HOST      = "your-lavalink-host"
LAVALINK_PASSWORD  = "your_password"
LAVALINK_SECURE    = "true"
LAVALINK_PORT      = ""

# ── Emoji Sync ────────────────────────────────────────────────────
EMOJI_SYNC         = "true"

# ── API / Dashboard Backend ───────────────────────────────────────
API_ENABLED        = "true"
API_PORT           = "8000"
DASHBOARD_API_KEY  = "change_this_to_a_strong_secret"
CORS_ORIGINS       = ""

# ── Cloudflare Tunnel ─────────────────────────────────────────────
TUNNEL_ENABLED     = "true"
CF_TUNNEL_TOKEN    = "your_tunnel_token"
CF_TUNNEL_URL      = "https://api.yourdomain.com"

# ── Webhooks ──────────────────────────────────────────────────────
WEBHOOK_URL        = "https://discord.com/api/webhooks/..."

4 — Run the bot

python CodeX.py

✦ Dashboard Setup

1 — Install dependencies

cd dashboard
npm install

2 — Configure the environment

Copy .env.example to .env.local:

NEXT_PUBLIC_API_URL           = https://api.yourdomain.com/api/v1
NEXT_PUBLIC_DASHBOARD_API_KEY = your_shared_api_key

NEXTAUTH_URL                  = http://localhost:3000
NEXTAUTH_SECRET               = a_long_random_string

DISCORD_CLIENT_ID             = your_discord_oauth_client_id
DISCORD_CLIENT_SECRET         = your_discord_oauth_client_secret

NEXT_PUBLIC_ADMIN_IDS         = your_discord_user_id
NEXT_PUBLIC_BRAND_NAME        = "ZyroX"
NEXT_PUBLIC_BRAND_NAME_WORD   = "ZX"

3 — Run locally

npm run dev

Open http://localhost:3000

��� Environment Reference

Bot — bot/.env

Dashboard — dashboard/.env.local

✦ HTTPS Tunnel (Cloudflare)

The bot uses pycloudflared — a Python package that downloads the cloudflared binary automatically on first run. No CLI installs, no system packages — works on Pterodactyl and any Python host.

Why Cloudflare over ngrok:

• ✅ Unlimited bandwidth & requests — no monthly caps
• ✅ Permanent URL that never changes between restarts
• ✅ Free — no paid plan needed
• ✅ Zero system installs — binary downloads via Python

Setup (browser only, no CLI needed):

1. Go to one.dash.cloudflare.com → Networks → Tunnels → Create a tunnel
2. Choose Cloudflared, give it a name (e.g. zyrox-api), save
3. On the Install connector step, copy the token from the command shown:

   cloudflared tunnel run --token <COPY_THIS>
   

4. Go to Public Hostname tab → add a hostname:
   • Subdomain: api · Domain: yourdomain.com · Service: http://localhost:8000
5. Add to bot/.env:

   CF_TUNNEL_TOKEN = "eyJhIjoiXXXX..."
   CF_TUNNEL_URL   = "https://api.yourdomain.com"
   

On every startup the console prints:

◈ Tunnel: cloudflared binary ready — starting tunnel on port 8000…
◈ Tunnel: API is live at  https://api.yourdomain.com
  ↳ NEXT_PUBLIC_API_URL = https://api.yourdomain.com/api/v1

✦ Deployment

🤖 Bot — any Python host

1. Upload the entire bot/ folder to your host (Pterodactyl, Render, Railway, Fly.io, VPS…)
2. Set the start command to python CodeX.py
3. Add all environment variables
4. pycloudflared downloads the binary automatically on first run — no extra steps

Recommended free/cheap hosts: Render · Railway · Fly.io · VPS

⭐ NexioHost — Premium bot hosting, built for Discord bots. Fast, reliable, and affordable.

🌐 Dashboard — Vercel

1. Go to vercel.com → Add New Project → connect your GitHub repo
2. Set root directory to dashboard/
3. Add all environment variables under Settings → Environment Variables
4. Add the OAuth redirect URI in Discord Developer Portal:

   https://your-app.vercel.app/api/auth/callback/discord
   

5. Hit Deploy — done ✓

✦ Emoji Sync

Runs automatically on startup when EMOJI_SYNC=true:

★ Starting Application Emoji Sync — 144 unique emojis found in emoji.py
◈ Found 144 templates | Application hosts 202 emojis
↑ Uploading: ztick  (not in application emojis)
✔ Uploaded: ztick  [saved as ID: 1234567890]
✔ emoji.py patched in-place to reflect current API state.
★ Restarting bot to load updated emoji IDs...

✦ Troubleshooting

✦ Security

• Never commit .env files — .gitignore already covers them
• Use a strong, unique NEXTAUTH_SECRET and DASHBOARD_API_KEY
• Rotate any secret that gets accidentally exposed
• The bot API is always behind an API key — never expose it without one