Discordeno

Discord API library for Node.JS, Deno & Bun

Getting started

More details are available in the documentation

- npm install @discordeno/bot
yarn add @discordeno/bot
pnpm install @discordeno/bot
bun install @discordeno/bot

[!TIP]

If you are not sure if Discordeno is right for you check everything below.

Packages

| Package | npm | Tests | | ------------------------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | discordeno | !npm | codecov</a> | | @discordeno/types | !npm | | | @discordeno/utils | !npm | | | @discordeno/rest | !npm | | | @discordeno/gateway | !npm | | | @discordeno/bot | !npm | |

Features

Discordeno is actively maintained to guarantee excellent performance, latest features, and ease of use.

Simple, Efficient, and Lightweight: Discordeno is lightweight, simple to use, and adaptable.

- By default: No caching.

Functional API:

- The functional API eliminates the challenges of extending built-in classes and inheritance while ensuring overall simple but performant code.

Cross Runtime: Supports the Node.js, Deno, and Bun runtimes.
Standalone components: Discordeno offers the option to have practically any component of a bot as a separate

piece, including standalone REST, gateways, custom caches, and more.

Flexibility/Scalability: Remove any properties, if your bot doesn't need them. For instance, remove Channel.topic if your bot doesn't require it. You may save GBs of RAM in this way. A few lines of code are all that are needed to accomplish this for any property on any object.

REST

Freedom from 1 hour downtimes due to invalid requests

- Prevent your bot from being down for an hour, by lowering the maximum downtime to 10 minutes.

Freedom from global rate limit errors

- As a bot grows, you need to handle global rate limits better. Shards don't communicate fast enough to truly handle it properly. With one point of contact to discords API, you will never have issues again. - Numerous instances of your bot on different hosts, all of which can connect to the same REST server.

REST does not rest!

- Separate rest guarantees that your queued requests will continue to be processed even if your bot breaks for whatever reason. - Seamless updates! When updating/restarting a bot, you'll lose a lot of messages or replies that are queued/processing.

Single point of contact to Discord API

- Send requests from any location, even a bot dashboard directly. - Don't send requests from dashboard to bot process to send a request to discord. Your bot process should be freed up to handle bot events!

Scalability! Scalability! Scalability!

Gateway

Zero Downtime Updates:

- Others: With non-proxy bots, it takes about 5s per shard bucket to start up. With 100,000 servers, this would be minimum of 8+ minutes of downtime for bot updates. - Discordeno Proxy Gateway: Resume the bot code almost instantly without worrying about any delays or wasting your identify limits.

Zero Downtime Resharding:

- Discord stops allowing your bot to be added to new servers when you max out your existing max shards. Consider a bot started with 150 shards operating on 150,000 servers. Your shards support a maximum of 150 \* 2500 = 375,000 servers. Your bot will be unable to join new servers once it reaches this point until it re-shards. - DD proxy provides 2 types of re-sharding. Automated and manual. You can also have both. - Automated: This system will automatically begin a Zero-downtime resharding process behind the scenes when you reach 80% of your maximum servers allowed by your shards. For example, since 375,000 was the max, at 300,000 we would begin re-sharding behind the scenes with ZERO DOWNTIME. - 80% of maximum servers reached (The % of 80% is customizable.) - Identify limits have room to allow re-sharding. (Also customizable) - Manual: You can also trigger this manually should you choose. - When discord releases a new API version, updates your gateways to new version with no downtime.

Horizontal Scaling:

- When your bot grows a lot, you have two options: you can either keep investing money to upgrade your server or you may expand horizontally by purchasing several more affordable servers. The proxy enables WS handling on multiple servers.

No Loss Restarts:

- Without the proxy mechanism, you would typically lose a lot of events while restarting. Users could issue instructions or send messages that are not automoderated. As your bot grows, this amount grows sharply. Users who don't receive the automatic roles or any other activities your bot should do. - While your bot is unavailable, events can be added to a queue, and once the bot is back online, the queue will start processing all of the events.

Flexibility:

- You have complete control over everything inside the gateway thanks to the controller aspect. Need to customize, the way the manager talks to the workers? Simply, plug in and override the method.

Clustering With Workers:

- Utilize all of your CPU cores to their greatest potential by distributing the workload across workers. To enhance efficiency, manage how shards per worker.

Custom Cache

Have your cache setup in any way you like. Redis, PGSQL or any cache layer you would like.

Links

Discordeno follows semantic versioning

Contributing/Developing

We use yarn as package manager and workspace manager, and turborepo as monorepo manager.

To config the workspace run

# if you don't have yarn installed npm install -g yarn

yarn install

Then you can build all the files and types across all packages using (unless specified all commands below are run at root directory)

yarn release-build

You can run unit tests on all packages using

yarn test:unit

Other useful information are available on the website under the contributing documentation

Other useful scripts (if you run in a package's directory, you need to build dist before test and build types before check. Running in root directory should automatically do it for you)

# format and lint the code
yarn check
check type
yarn test:type
check type for tests
yarn test:test-type
unit test showing coverage
yarn test:unit-coverage
unit test with Deno
yarn test:deno-unit
unit test with Bun
yarn test:bun-unit
integration test
yarn test:integration
e2e test
yarn test:e2e
build doc for website
yarn build:doc

discordeno/discordeno: Discord API library for Node and Deno

Discordeno

Getting started

Packages

Features

REST

Gateway

Custom Cache

Links

Contributing/Developing

check type

check type for tests

unit test showing coverage

unit test with Deno

unit test with Bun

integration test

e2e test

build doc for website

Reading Mode

Related Stories

Honest question: at this price and performance, would you use this memory API?

U.K. Sanctions Cryptomus for RU Money Laundering

Honest question: at this price and performance, would you use this memory API?

I pulled verified revenue for 5,596 startups. Here's exactly what to build in 2026 (11 benchmarks, 25 templates)

How do I cap inference billing to avoid surprise costs from idle GPUs or runaway agents?

Related Stories