# @atlasbot/discord-utilities

Latest version **10.6.0** (published 2026-11-19) · AGPL-3.0 license · 0 weekly downloads

## Install

```sh
npm install @atlasbot/discord-utilities
pnpm add @atlasbot/discord-utilities
yarn add @atlasbot/discord-utilities
bun add @atlasbot/discord-utilities
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 10.6.0 |
| Published | 2026-11-19 |
| First published | 2023-08-17 |
| Weekly downloads | 0 |
| License | AGPL-3.0 |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 0 |
| Unpacked size | 38.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 27 |
| Maintainers | ryanke |

## Links

- npm: https://www.npmjs.com/package/@atlasbot/discord-utilities
- Repository: https://github.com/sylv/atlas
- npm.io page: https://npm.io/package/@atlasbot/discord-utilities

## Recent versions

- 10.6.0 (latest) — 2026-11-19
- 10.5.16 — 2024-05-06
- 10.5.15 — 2024-02-24
- 10.5.14 — 2023-12-29
- 10.5.12 — 2023-08-17

## README

<p align="center">
    <img src="./assets/alternatives/pride_transparent_500x500_lq.png" height="256" width="256" />
</p>
<p align="center">
  <img src="https://skillicons.dev/icons?i=next,tailwind,nest,rust,typescript,docker,kubernetes,graphql" />
  <br/>
  <a href="https://atlas.bot/support"><kbd>🔵 discord</kbd></a> <a href="https://atlas.bot"><kbd>🟣 website</kbd></a>
</p>

# atlas

> [!NOTE]
> Atlas is not and will never be self-hostable. If that's what you're here for, you're out of luck.

> [!WARNING]
> This repo is missing some parts of the bot, but over time most will be added.

A Discord bot to unlock your creativity and unify your community.

## how

`pandora` connects to Discord and caches data from events, then dumps them into a nats queue. `bot` consumes those events and processes them. When the worker needs cached info, it talks to `pandora` over gRPC, in production through `eridium` so it can talk to the right `pandora` instance. When the worker needs to send data to Discord, it uses the `elpis` library which goes through a proxy service handling ratelimiting aross the whole bot.

The GraphQL API `api` for the dashboard `web` both talk to `pandora` over gRPC for cached data and in the future, some realtime capabiltiies.

libraries or services with links are open source. the rest are _currently_ closed source, but may be open sourced in the future.

### services

- `api` - the GraphQL API for the dashboard
- `bot` - the worker service that consumes events from `pandora` and processes them using `elpis`
- `eridium` - a grpc proxy that takes requests from `bot` and sends them to the `pandora` instance that has the relevant cache
- `pandora` - the gateway service that connects to Discord and caches data
- `web` - the dashboard

### libraries

- [colour](./packages/colour) - colour utilities and presets
- [core](./packages/core) - reusable generic utilities used in many places, including the web
- [discord-utilities](./packages/discord-utilities) - utilities for Discord, closely tied to elpis but can run in browsers
- [emoji](./packages/emoji) - emoji sheets and utilities for dealing with ~~an abomination~~ emojis
- [parsers](./packages/parsers) - does this need an explanation? numbers, booleans, time - dealing with humans is hard.
- [razorback](./packages/razorback) - an experimental reimplementation of our scripting language `pella`
- `common` - [core](./packages/core) but specific to server-side code.
- `elpis` - wraps discords API and pulls from pandora for cached data instead of having its own cache. also handles ratelimiting through a proxy.
- `pella` - our custom scripting language.
- `logging` - wraps pino and makes it easier to reuse.

---
_Source: https://npm.io/package/@atlasbot/discord-utilities · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
