galactic is a powerful scaling library for Discord bots, built to make distributed shard and cluster management simple, efficient, and highly flexible.

Overview

galactic allows you to run multiple Discord shards within a single process and scale your bot seamlessly across multiple machines or containers. It’s designed to integrate smoothly with discord.js, enabling developers to focus on building features instead of managing complex scaling setups.

Key Features

- Run multiple Discord shards in one process
- Automate cluster distribution across multiple machines or Docker containers
- Utilize the galactic Bridge to synchronize shards and clusters
- Seamless integration with discord.js
- Optimized for both small and large-scale bot deployments
- Easy configuration and setup
- Open-source and actively maintained
- Reclustering without downtime

Installation

``bash npm install galactic.ts

`or`


yarn add galactic.ts


Quick Start Example

`ts filename="index.ts" import {StandaloneInstance} from "galactic.ts";

// Create a standalone instance running 2 clusters with 2 shards each const machine = new StandaloneInstance(${__dirname}/bot.js, 2, 2, process.env.TEST_SA_BOT_TOKEN!, [] );

machine.start();`

`ts filename="bot.ts" import {Cluster} from "galactic.ts"; import {Client, ClientOptions} from "discord.js";

// Extend the Discord Client to include a reference to its Cluster export class ExtendedClient extends Client { cluster: Cluster;

constructor(options: ClientOptions, cluster: Cluster) { super(options); this.cluster = cluster; } }

// Initialize the Cluster const cluster = Cluster.initial();

const client = new ExtendedClient({ shards: cluster.shardList, shardCount: cluster.totalShards, intents: cluster.intents, }, cluster);

cluster.client = client;

client.login(cluster.token)``

Distributed Setup

To scale your bot across multiple servers or containers, galactic uses the galactic Bridge.
Each instance connects to the same bridge to coordinate shard and cluster responsibilities.

Typical setup:
1. Deploy multiple galactic instances (e.g., on different VPS or Docker nodes)
2. Configure each instance to connect to the same galactic Bridge
3. galactic automatically balances shards across all connected nodes

Integration with Discord.js

galactic is fully compatible with the latest version of discord.js.
You can integrate it without modifying your existing command or event handling structure.

Use Cases

- Running high-traffic bots with thousands of guilds
- Horizontal scaling using containers (Docker, Kubernetes)
- Efficient utilization of hardware on a single machine

License

!Galactic Logo